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țiCel mai probabil stratCea mai bună mișcare următoare
Pagina Workbench nu se încarcăSite, browser, DNS sau cale de rețea WorkbenchDeschideți Salesforce Trust Status și testați site-ul dintr-o rețea alternativă permisă.
Workbench se încarcă, dar autentificarea eșuează cu eroarea 401Sesiune, OAuth, nume de utilizator, parolă sau flux de conectareÎncepeți o nouă autentificare autorizată și confirmați mediul selectat.
Cererea API returnează codul 403Permisiuni, politică pentru aplicații conectate sau limită APIVerificaț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 503Platforma Salesforce, rutare la margine, întreținere sau supraîncărcareComparaț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 datelorReduceț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.

Ecran ilustrativ de conectare la Workbench care prezintă câmpurile Standard, Avansat, OAuth, Mediu, Versiune API, Nume utilizator, Parolă, ID sesiune și URL server
Î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:

  1. 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.
  2. 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.

Pagină ilustrativă de stare a încrederii Salesforce cu un câmp Instanță de căutare sau Domeniu care conține compania mea și un rezultat Instanță disponibilă
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.

CodIndiciu documentat SalesforceCum să o interpretezi în timpul perioadelor de nefuncționare
400Cererea 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.
401ID-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.
403Cererea 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.
500A apărut o eroare în platforma Lightning.Reîncercați numai după înregistrarea răspunsului; comparați eșecurile repetate cu Statusul de încredere.
502Salesforce 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.
503Serverul 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.
Ecran ilustrativ de solicitare API Workbench care afișează o solicitare GET sigură și rânduri de răspuns pentru erorile 401 Sesiune nevalidă, 502 Salesforce Edge, 503 Serviciu indisponibil și 500 Eroare internă server
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ă.

  1. Repetați aceeași solicitare inofensivă o dată după înregistrarea primului răspuns.
  2. Dacă solicitarea returnează codul 401, începeți un nou flux de autentificare autorizată, în loc să reutilizați o sesiune veche.
  3. Dacă returnează 400, 403 sau 404, verificați endpoint-ul, versiunea API, numele obiectului, permisiunile și corpul cererii.
  4. Dacă returnează 500, 502 sau 503 în mod repetat, comparați ora și instanța cu Statusul de încredere.
  5. 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.

Pagina ilustrativă „Despre Workbench” care arată notificări conform cărora Workbench nu este un produs oficial Salesforce, nu este acceptat de Salesforce, nu ar trebui utilizat cu date de producție și are suport din partea comunității open-source.
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.

Ce dovezi ar trebui să trimiteți către Asistență?

Dacă problema Salesforce persistă, utilizați îndrumările oficiale de asistență Salesforce pentru canalul disponibil în cadrul Planului dvs. de succes. Includeți:

  • Identificator organizațional, instanță și mediu
  • Marcajul orar UTC și fusul orar local
  • Pagina Workbench sau operațiunea API implicată
  • 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:

  1. Confirmați că pagina incidentului afișează o rezoluție sau instanța revine la starea Disponibilă.
  2. Conectați-vă prin fluxul Salesforce sau Workbench aprobat fără a reutiliza o sesiune învechită.
  3. Executați aceeași solicitare doar în citire inofensivă care a eșuat anterior.
  4. Comparați codul HTTP, timpul de răspuns și corpul răspunsului cu eroarea înregistrată.
  5. 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ă.

Surse oficiale

Lasă un comentariu

Collabora Online vs ONLYOFFICE: Măsurați memoria RAM și latența de editare

Collabora Online vs ONLYOFFICE: Măsurați memoria RAM și latența de editare

Comparați Collabora Online și ONLYOFFICE Docs pe același server cu un test repetabil pentru utilizarea memoriei, timpul de deschidere a documentului și întârzierea editării colaborative.

ONLYOFFICE Docs vs Microsoft 365 Web: Care dintre ele continuă să se formateze?

ONLYOFFICE Docs vs Microsoft 365 Web: Care dintre ele continuă să se formateze?

Comparați comportamentul documentelor, foilor de calcul și layout-urilor în ONLYOFFICE Docs și aplicațiile web Microsoft 365, apoi utilizați un test rapid pentru a alege editorul mai sigur pentru fișierele dvs.

De ce se schimbă o formulă de foaie de calcul între ONLYOFFICE și Excel

De ce se schimbă o formulă de foaie de calcul între ONLYOFFICE și Excel

Urmăriți neconcordanțele de formule cu sintaxa, separatoarele regionale, recalcularea, sistemele de date sau funcțiile neacceptate, apoi verificați registrul de lucru înainte de a-l partaja.

ONLYOFFICE vs LibreOffice: Ce arată testele de performanță

ONLYOFFICE vs LibreOffice: Ce arată testele de performanță

Vedeți ce pot dovedi – și ce nu pot dovedi – datele despre lansări recente, apoi comparați ambele suite de birou pe aceleași fișiere și pe același computer.

Calc VLOOKUP vs XLOOKUP: Alegeți formula de căutare potrivită

Calc VLOOKUP vs XLOOKUP: Alegeți formula de căutare potrivită

Compară potriviri exacte, căutări în partea stângă, gestionarea valorilor lipsă și suport pentru versiuni, astfel încât să poți alege o formulă Calc fiabilă.

Numere de pagină Writer vs. Word: Stiluri, secțiuni și restarturi

Numere de pagină Writer vs. Word: Stiluri, secțiuni și restarturi

Aflați cum stilurile de pagină din Writer și linkurile secțiunilor din Word afectează paginile de copertă, cifrele romane și repornirea numerotării atunci când mutați un document.

Centrul de software Pardus sau APT? Alegerea instrumentului potrivit

Centrul de software Pardus sau APT? Alegerea instrumentului potrivit

Comparați Pardus Software Center cu comenzile APT pentru a găsi, instala, elimina și actualiza pachete folosind metoda care se potrivește sarcinii dumneavoastră.

Pardus 25.2 XFCE vs GNOME: O comparație corectă a memoriei RAM

Pardus 25.2 XFCE vs GNOME: O comparație corectă a memoriei RAM

Vedeți ce înseamnă cerințele de RAM publicate de Pardus, apoi comparați XFCE și GNOME pe același PC cu citiri MemAvailable repetabile.

Poate sistemul de operare HamoniKR să satisfacă nevoile desktop ale întreprinderilor?

Poate sistemul de operare HamoniKR să satisfacă nevoile desktop ale întreprinderilor?

Vedeți unde se încadrează HamoniKR 8.0 într-un plan desktop pentru afaceri, ce funcții oferă specializarea coreeană și ce trebuie să verificați înainte de o lansare pe scară mai largă.

Securitatea Gooroom: Ce fac de fapt bootarea de încredere și izolarea

Securitatea Gooroom: Ce fac de fapt bootarea de încredere și izolarea

Înțelegeți cum se integrează verificarea la pornire și protecțiile la rulare oferite de Gooroom, ce înseamnă „sandbox” și ce setări ar trebui să verificați pe dispozitiv.