Acasă
» Tehnologie
»
Erori Salesforce Workbench: Depanarea instrumentelor API în timpul perioadelor de nefuncționare
Erori Salesforce Workbench: Depanarea instrumentelor API în timpul perioadelor de nefuncționare
Verificat pe 16 septembrie 2026. Erorile Workbench sunt ușor de interpretat greșit în timpul unui incident Salesforce. O conectare eșuată poate proveni dintr-o sesiune expirată, un mediu greșit, o rută Workbench întreruptă sau o întrerupere a API-ului Salesforce. O solicitare care returnează 503 Service Unavailablepuncte într-o direcție diferită de o 401 Invalid Session, chiar dacă ambele pot apărea atunci când un dezvoltator încearcă să lucreze rapid.
Scopul depanării nu este de a forța o singură solicitare. Este de a identifica ce nivel cedează, de a proteja datele cât timp sistemul este instabil și de a ști când dovezile sunt suficient de puternice pentru a aștepta, a schimba instrumentele sau a contacta canalul de asistență potrivit.
Diagnostic rapid: ce indică cel mai probabil eroarea?
Ceea ce vedeți
Cel mai probabil strat
Cea mai bună mișcare următoare
Pagina Workbench nu se încarcă
Site, browser, DNS sau cale de rețea Workbench
Deschideți Salesforce Trust Status și testați site-ul dintr-o rețea alternativă permisă.
Workbench se încarcă, dar autentificarea eșuează cu eroarea 401
Sesiune, OAuth, nume de utilizator, parolă sau flux de conectare
Începeți o nouă autentificare autorizată și confirmați mediul selectat.
Cererea API returnează codul 403
Permisiuni, politică pentru aplicații conectate sau limită API
Verificați limitele utilizatorului, ale aplicației conectate și ale solicitărilor; nu tratați acest lucru ca o dovadă a unei perioade de nefuncționare.
Mai multe apeluri API returnează 500, 502 sau 503
Platforma Salesforce, rutare la margine, întreținere sau supraîncărcare
Comparați timpul de eroare cu instanța și starea produsului dvs. pe Trust.
Doar o singură interogare sau un singur obiect eșuează
Sintaxa solicitării, accesul la obiecte, partajarea înregistrărilor sau problema datelor
Reduceți solicitarea la o citire inofensivă, cunoscută ca fiind validă, și inspectați corpul răspunsului.
Acest tabel este un punct de plecare, nu un diagnostic. Același cod HTTP poate avea cauze diferite în funcție de endpoint, metoda de autentificare și politica organizației.
Mai întâi, înțelegeți limita de suport a Workbench-ului
Workbench este o suită bazată pe browser pentru interacțiunea cu organizațiile Salesforce prin intermediul mai multor API-uri, inclusiv REST, SOAP, Bulk, Streaming, Metadate și instrumente legate de Apex. Cu toate acestea, site-ul Workbench afirmă că nu este un produs oficial Salesforce și că asistența Salesforce nu este disponibilă pentru Workbench în sine. Pagina sa Despre avertizează, de asemenea, utilizatorii să nu utilizeze aplicația cu date de producție.
Această avertizare schimbă modul în care ar trebui să reacționați în timpul perioadelor de nefuncționare. Asistența Salesforce poate investiga o problemă legată de un serviciu, o instanță sau un API Salesforce, dar este posibil să nu depaneze fiecare comportament al interfeței Workbench. În schimb, o problemă raportată doar de Workbench poate aparține Workbench sau căii de browser, mai degrabă decât platformei Salesforce.
Păstrați fișierele de depanare doar pentru citire ori de câte ori este posibil. Nu inserați parole, secrete OAuth, ID-uri de sesiune, token-uri de acces, înregistrări ale clienților sau anteturi de solicitări needitate în capturi de ecran, mesaje de chat sau rapoarte publice despre probleme.
Începeți prin a identifica calea de conectare Workbench și mediul selectat. Interfața afișată este o machetă ilustrativă, nu un ecran de conectare live sau o solicitare de introducere a credențialelor într-o imagine a articolului.
Pasul 1: Verificați starea de încredere Salesforce înainte de a modifica setările Workbench
Deschideți Starea de încredere Salesforce într-o filă separată. Documentația de ajutor Salesforce direcționează clienții către această pagină pentru întreruperi ale produselor și degradarea serviciilor, iar site-ul de încredere poate afișa informații despre produse, precum și instanțe specifice.
Verificați două vizualizări:
Perspectiva generală asupra produsului: căutați un incident, o degradare a serviciului, o întrerupere sau un eveniment de întreținere care afectează serviciul Salesforce pe care îl utilizați.
Vizualizarea instanței dvs.: căutați instanța dvs. sau Domeniul meu și deschideți rezultatul corespunzător.
O instanță marcată ca Disponibilă nu garantează că fiecare operațiune API va funcționa. Înseamnă că instanța și serviciile sale sunt disponibile conform definiției de stare Salesforce. Degradarea performanței sugerează că accesul poate funcționa cu latență sau funcționalitate parțială; Întreruperea serviciului înseamnă că instanța nu este disponibilă; Întreținere indică un eveniment de întreținere care poate afecta sau nu accesul.
Pasul 1 — Comparați informațiile generale despre starea de încredere cu instanța organizației afectate. Ecranul afișat este un ghid ilustrativ pentru fluxul de lucru de căutare documentat, nu o dovadă a unui incident real.
Pasul 2: Confirmați mediul și organizația înainte de a reîncerca
Workbench se poate conecta la diferite medii Salesforce. Înainte de a concluziona că o API este nefuncțională, confirmați dacă solicitarea eșuată vizează producția, un sandbox sau un alt mediu autorizat. Un test care reușește într-un mediu nu elimină mediul care eșuează efectiv.
Folosiți identificatorul Domeniului meu sau al instanței pentru organizația afectată. Salesforce documentează faptul că prefixul Domeniului meu poate fi utilizat în Starea de încredere, în timp ce un administrator poate găsi instanța în Configurare, sub Informații despre companie . Notați instanța, mediul, versiunea API, timpul aproximativ de eroare și punctul final. Această mică înregistrare previne o greșeală frecventă: compararea unei erori de producție cu o stare sănătoasă a sandbox-ului.
Dacă pagina de conectare Workbench afișează o metodă de conectare neacceptată sau revine la ecranul de conectare, tratați acest lucru ca o problemă separată de autentificare sau Workbench până când Statusul de încredere și o conectare directă la Salesforce indică contrariul. Nu trimiteți în mod repetat acreditări în timpul unei întreruperi suspectate; reîncercările excesive pot crea blocări sau pot adăuga zgomot investigației.
Pasul 3: Clasificați răspunsul API în loc să ghiciți
Documentația API-ului REST de la Salesforce explică faptul că antetul răspunsului conține un cod de stare HTTP și că, de obicei, corpul conține un mesaj și, atunci când este relevant, câmpul sau obiectul asociat cu eroarea. Păstrați ambele dovezi.
Cod
Indiciu documentat Salesforce
Cum să o interpretezi în timpul perioadelor de nefuncționare
400
Cererea nu a putut fi înțeleasă, adesea deoarece corpul JSON sau XML este nevalid.
De obicei, remediați solicitarea înainte de a o trata ca pe o întrerupere.
401
ID-ul sesiunii sau token-ul OAuth a expirat sau este invalid.
Reautentificați-vă printr-un flux aprobat; un cod 401 în sine nu constituie o dovadă a unei întreruperi a platformei.
403
Cererea a fost refuzată, adesea din cauza permisiunilor sau a unei limite API.
Verificați accesul și limitele înainte de a escalada situația ca un incident de disponibilitate.
500
A apărut o eroare în platforma Lightning.
Reîncercați numai după înregistrarea răspunsului; comparați eșecurile repetate cu Statusul de încredere.
502
Salesforce Edge nu a putut comunica cu succes cu instanța.
O problemă de rutare sau de pe partea platformei este posibilă, în special în cazul mai multor cereri.
503
Serverul nu este disponibil; pot fi implicate lucrări de întreținere sau supraîncărcare.
Verificați dacă există un incident sau un eveniment de întreținere și evitați reîncercările distructive.
Pasul 3 — Înregistrați codul HTTP și semnificația răspunsului înainte de a modifica acreditările sau solicitările. Exemplul nu conține niciun token, date despre clienți sau identificator real de incident.
Pasul 4: Rulați un test de comparație sigur
După ce cunoașteți starea și mediul, utilizați cel mai mic test permis, doar pentru citire. O comparație bună are trei proprietăți: vizează organizația afectată, nu modifică datele și este suficient de simplă încât o eroare de format a cererii este puțin probabilă.
Repetați aceeași solicitare inofensivă o dată după înregistrarea primului răspuns.
Dacă solicitarea returnează codul 401, începeți un nou flux de autentificare autorizată, în loc să reutilizați o sesiune veche.
Dacă returnează 400, 403 sau 404, verificați endpoint-ul, versiunea API, numele obiectului, permisiunile și corpul cererii.
Dacă returnează 500, 502 sau 503 în mod repetat, comparați ora și instanța cu Statusul de încredere.
Dacă interfața browserului funcționează, dar Workbench eșuează, testați aceeași cale API autorizată cu un client intern aprobat sau o diagnosticare de integrare.
Nu utilizați o solicitare de scriere, ștergere, actualizare în bloc, implementare de metadate sau migrare ca verificare a stării de funcționare. În timpul unui incident, o scriere poate crea rezultate parțiale, poate duplica munca sau poate crea o impresie falsă că a avut loc recuperarea.
Când ar trebui să vă schimbați abordarea de depanare?
Schimbați abordarea atunci când Statusul de Încredere indică un incident
Opriți reproiectarea interogării decât dacă aveți dovezi independente că solicitarea este incorectă. Salvați numărul incidentului, serviciul afectat, instanța, ora de începere și cea mai recentă actualizare. Urmați mesajele de recuperare Salesforce și protejați lucrările din coadă de încercările duplicate.
Schimbați abordarea când Statusul de încredere este disponibil, dar Workbench-ul singur eșuează
Concentrați-vă pe Workbench, browser, rețea, autentificare sau politică locală. Încercați o fereastră privată de browser, un browser alternativ acceptat și o comparație de rețele permisă. Site-ul Workbench direcționează asistența specifică Workbench către resursele comunității sale open-source, în timp ce Salesforce Help rămâne ruta pentru asistența pentru produsele și conturile Salesforce.
Schimbați abordarea când eroarea este constantă 401 sau 403
Treceți la analiza identității și a autorizării. Confirmați utilizatorul, politica aplicației conectate, domeniul de aplicare OAuth, vechimea sesiunii, accesul API, profilul sau setul de permisiuni și limitele organizației. Reîmprospătarea repetată a browserului nu va repara o permisiune lipsă sau un token nevalid.
Schimbați abordarea când un endpoint eșuează, dar citirile simple funcționează
Investigați endpoint-ul, obiectul, câmpul, partajarea înregistrărilor, versiunea API, corpul cererii și corpul răspunsului. O eroare limitată nu este suficientă pentru a eticheta Salesforce la nivel global. Reduceți cererea până când puteți identifica dacă problema este sintaxa, accesul, datele sau un serviciu dependent.
Pasul 4 — Respectați limitele de asistență și siguranță ale Workbench. Folosiți asistența Salesforce aprobată pentru incidentele platformei și resursele comunității open-source pentru comportamentul specific Workbench.
Cod HTTP, cod de eroare și corp de răspuns redactat
Dacă interfața cu utilizatorul Salesforce, un alt utilizator sau un alt client aprobat eșuează, de asemenea
Numărul incidentului de Stare de Încredere sau o notă care indică faptul că nu a fost vizibil niciun eveniment corespondent
Eliminați acreditările, ID-urile de sesiune, token-urile de acces, numele clienților, ID-urile de înregistrare și sarcinile utile sensibile înainte de a trimite jurnalele. Dacă problema este doar legată de Workbench, utilizați ruta de asistență identificată pe pagina de ajutor Workbench ; Salesforce nu oferă asistență pentru produsul Workbench în sine.
Cum se verifică recuperarea
Un indicator de stare verde este încurajator, dar nu reprezintă linia de sosire. Verificați recuperarea în straturi:
Confirmați că pagina incidentului afișează o rezoluție sau instanța revine la starea Disponibilă.
Conectați-vă prin fluxul Salesforce sau Workbench aprobat fără a reutiliza o sesiune învechită.
Executați aceeași solicitare doar în citire inofensivă care a eșuat anterior.
Comparați codul HTTP, timpul de răspuns și corpul răspunsului cu eroarea înregistrată.
Verificați integrările, joburile aflate în coadă și notificările din aval pentru lucrări întârziate sau duplicate.
Rezultatul dorit nu este pur și simplu „pagina deschisă”. Doriți ca operațiunea autorizată inițială să aibă succes, cu răspunsul așteptat și fără efecte secundare neravizuite.
Listă de verificare pentru autoevaluare
Domeniu de aplicare: Ați verificat atât pagina de încredere la nivel de produs, cât și instanța afectată?
Mediu: Ați confirmat producția versus sandbox și Domeniul meu sau instanța corectă?
Dovadă: Ați salvat codul HTTP exact, codul de eroare, ora și răspunsul redactat?
Siguranță: Ați evitat solicitările de scriere, ștergere, implementare în bloc, implementare și migrare în timpul incidentului?
Decizie: Ați făcut distincția între comportamentul Workbench-ului exclusiv și eșecul API-ului Salesforce?
Recuperare: Ați retestat operațiunea inițială și ați inspectat lucrările ulterioare întârziate?
Concluzie
Pentru erorile Salesforce Workbench în timpul perioadelor de nefuncționare, începeți cu Starea de încredere și instanța afectată, apoi clasificați răspunsul HTTP înainte de a modifica acreditările sau a rescrie cererile. O eroare repetată 500, 502 sau 503 în teste simple doar în citire și un incident de încredere corespunzător susține o explicație din partea Salesforce. O eroare 401, 403, 400 sau doar Workbench necesită de obicei autentificare, permisiuni, cereri, browser sau depanare Workbench. Deoarece Workbench nu este un produs acceptat de Salesforce, păstrați datele de producție în afara acestuia, documentați clar limita și utilizați cea mai recentă stare oficială și îndrumări de asistență atunci când dovezile se modifică.