Chyby Salesforce Workbench: Riešenie problémov s nástrojmi API počas prestojov

Chyby Salesforce Workbench počas prestojov: začnite oddelením zlyhania nástroja od zlyhania platformy

Keď sa Salesforce Workbench náhle prestane prihlasovať, REST Explorer vráti chybu alebo dotaz, ktorý fungoval pred pár minútami, začne vypršať, najrýchlejšou cestou je neklikať na tlačidlo Opakovať. Najprv zistite, ktorá vrstva zlyháva: webová aplikácia Workbench, váš prehliadač alebo sieť, overenie Salesforce, vaša konkrétna inštancia Salesforce alebo samotná požiadavka API.

Toto rozlíšenie je dôležité, pretože Workbench je webový API nástroj spravovaný komunitou, a nie plne podporovaný produkt Salesforce. Salesforce výslovne uvádza, že Workbench neudržiava a odporúča podporované alternatívy, ako napríklad Salesforce CLI, Code Builder a Salesforce Extensions pre Visual Studio Code. Samotný projekt Workbench tiež opisuje nástroj ako nástroj určený len na údržbu. Pozrite si pokyny pre nahradenie Workbenchu ​​od Salesforce a pôvodný zdrojový kód Workbenchu .

Túto stránku použite ako praktickú referenciu, keď existuje podozrenie na výpadok alebo zhoršenú službu. Cieľom je zachovať dôkazy, vyhnúť sa zbytočným opakovaným pokusom a rozhodnúť sa, či počkať, zmeniť nástroje alebo opraviť niečo lokálne.

Ilustratívne okno prehliadača Salesforce Workbench zobrazujúce chybu prihlásenia bez zverejnenia prihlasovacích údajov
Ilustratívna chyba pripojenia k pracovnému stolu. Pred zmenou nastavení alebo opakovaným pokusom o pripojenie zaznamenajte presnú správu.

Kontrolný zoznam pre rýchle triedenie

SkontrolovaťNa čo si dať pozorČo vám to hovorí
Dôvera SalesforceDopad na incident, zhoršenie stavu, údržbu alebo konkrétnu inštanciuČi Salesforce hlási problém na strane platformy
Samotný pracovný stôlMôže sa načítať prihlasovacia stránka? Presmeruje OAuth správne?Či je nástroj hostovaný komunitou dostupný
Prihlásenie do SalesforceVieš sa normálne prihlásiť do organizácie?Či je overovanie ovplyvnené vo všeobecnosti
Minimálne volanie APIVyskúšajte odľahčený koncový bod, ako napríklad /services/data/alebo/services/data/v66.0/limitsČi cesta k rozhraniu API funguje nezávisle od zložitého dopytu
Kód chyby401, 403, 404, 5xx, časový limit, REQUEST_LIMIT_EXCEEDED,UNSUPPORTED_API_VERSIONKtorú vetvu na riešenie problémov sledovať
Druhý klientRozhranie príkazového riadka Salesforce, existujúca integrácia alebo iný schválený klient APIČi je zlyhanie špecifické pre Workbench

1. Pred zmenou konfigurácie skontrolujte dôveryhodnosť Salesforce

Prejdite na oficiálnu stránku dôveryhodnosti Salesforce a vyhľadajte inštanciu, doménu, pod alebo nájomníka relevantného pre vašu organizáciu. Incidenty Salesforce môžu byť regionálne alebo špecifické pre inštanciu, takže zelený stav pre nesúvisiacu inštanciu nedokazuje, že vaša organizácia je v poriadku.

Ak služba Trust nahlási prerušenie služby, zníženie výkonu, problém s prihlásením alebo údržbu ovplyvňujúcu vaše prostredie, zaznamenajte si ID a čas incidentu. Potom sa vyhnite špekulatívnym zmenám v pripojených aplikáciách, povereniach, profiloch, sadách povolení, sieťových politikách alebo verziách API, pokiaľ chyba konkrétne neodkazuje na tieto nastavenia. Zmeny konfigurácie vykonané počas výpadku môžu po obnovení platformy spôsobiť druhý problém.

Ilustratívna stránka so stavom dôveryhodnosti Salesforce s riadkami služieb a jedným zvýrazneným riadkom prerušenia
Na overenie aktívneho stavu vašej vlastnej inštancie použite stránku Salesforce Trust. Stavy zobrazené tu sú ilustračné; zdrojom pravdy je stránka live Trust.

2. Zachovajte presnú chybu Workbenchu ​​a klasifikujte ju

Workbench často prepúšťa odpovede na chyby rozhrania Salesforce API s malou interpretáciou. To je užitočné pri riešení problémov: presný stav HTTP, kód chyby Salesforce, koncový bod a správa vám zvyčajne povedia viac ako všeobecný banner prehliadača.

Zlyhanie pripojenia, časový limit alebo HTTP 5xx

Časový limit, chyba 502, 503 alebo iná odpoveď 5xx môže byť konzistentná so zhoršením služby, preťaženou infraštruktúrou alebo prechodným zlyhaním siete. Nepredpokladajte, že chyba 5xx dokazuje výpadok celého systému Salesforce. Porovnajte rovnakú ľahkú požiadavku od iného schváleného klienta a skontrolujte dôveryhodnosť. Ak viacero klientov zlyhá na tej istej inštancii Salesforce súčasne, dôkazy poukazujú na inak ako samotný systém Workbench.

Chyby 401 alebo neplatná relácia

Tieto problémy zvyčajne poukazujú na problémy s overovaním alebo reláciou. Namiesto kopírovania starých ID relácií medzi prehliadačmi vykonajte opätovnú autentifikáciu pomocou OAuth. Ak zlyhá aj bežné prihlásenie do Salesforce a Trust hlási vplyv na prihlásenie, pred rotáciou prihlasovacích údajov počkajte na obnovenie služby. Ak prihlásenie do Salesforce funguje, ale OAuth do Workbench nie, preskúmajte cestu pripojenej aplikácie Workbench alebo použite podporovaného alternatívneho klienta.

Chyby 403 a autorizácie

Kód 403 zvyčajne znamená, že požiadavka dorazila k službe, ktorá ju odmietla. Skontrolujte povolenia používateľa, pravidlá pre pripojenú aplikáciu, obmedzenia IP adries a presný kód chyby Salesforce. Jeden známy príklad špecifický pre Workbench je chyba , ktorá sa môže vyskytnúť, keď správca zablokuje pripojenú aplikáciu Workbench. Tento scenár popisuje návod na pripojenie aplikácieOAUTH_APP_BLOCKED v projekte Workbench .

3. Zredukujte test na najmenšiu bezpečnú požiadavku na API

Počas podozrenia na výpadok nediagnostikujte hromadné načítanie, nasadenie metadát, dlhý dotaz SOQL alebo viackrokový skript. Začnite s koncovým bodom iba na čítanie, ktorý sa ľahko vykonáva. V REST Exploreri požiadavka, ako napríklad , GET /services/data/kontroluje základnú dostupnosť rozhrania API. Požiadavka, ako napríklad , GET /services/data/v66.0/limitsvám môže pomôcť skontrolovať limity organizácie, keď rozhranie API funguje.

Salesforce dokumentuje Workbench REST Explorer ako spôsob volania REST koncových bodov, ale Workbench nie je ideálny pre rozsiahle alebo výkonnostne náročné operácie. Pôvodná dokumentácia Workbenchu ​​uvádza, že časové limity prehliadača a pripojenia ho robia vhodnejším pre rýchle interakcie s API za behu ako pre veľké načítania alebo exporty údajov.

Ilustratívny REST Explorer v nástroji Workbench zobrazujúci požiadavku GET na koncový bod limitov a odpoveď na chybu API
REST Explorer je užitočný pre minimálne reprodukovateľné požiadavky. Zaznamenajte si stav HTTP a chybový kód Salesforce, namiesto toho, aby ste sa spoliehali iba na bannerovú správu.

4. Chyby obmedzení API zaobchádzajte inak ako prestoje

REQUEST_LIMIT_EXCEEDEDnie je to isté ako výpadok platformy. Salesforce uplatňuje alokácie požiadaviek API a keď organizácia prekročí svoj priebežný limit používania, ďalšie volania API môžu byť blokované, kým používanie neklesne pod prahovú hodnotu. Článok podpory Salesforce z júla 2026 potvrdzuje, že volania REST API, SOAP API, Bulk API a Bulk API 2.0 prispievajú k spotrebe API. Pozrite si pokyny Salesforce pre REQUEST_LIMIT_EXCEEDED a vysvetlenie priebežného limitu API .

Ak je chyba limitnou podmienkou, opakované pokusy situáciu zhoršujú tým, že spotrebúvajú viac volaní, aj keď sú požiadavky stále akceptované. Identifikujte integrácie s vysokým objemom, pozastavte nepodstatné úlohy tam, kde je to prevádzkovo bezpečné, a monitorujte používanie v nastavení Salesforce. Nečakajte na incident dôveryhodnosti, aby ste vyriešili problém s limitom špecifickým pre nájomníka.

5. Skontrolujte nezhodu medzi verziami API

UNSUPPORTED_API_VERSIONzaslúži si vlastnú vetvu. Salesforce publikoval v máji 2026 článok podpory, v ktorom vysvetľuje, že Workbench môže predvolene nastaviť novšiu verziu API skôr, ako ju bude podporovať produkčná organizácia alebo organizácia Developer Edition. Odporúčaná oprava Workbenchu ​​je znížiť predvolenú verziu API na verziu podporovanú cieľovou organizáciou. Pozrite si článok o riešení problémov UNSUPPORTED_API_VERSION od Salesforce .

Toto je dôležité počas obdobia vydania, pretože nesúlad medzi verziou API môže vyzerať ako výpadok, ak sa zameriate iba na načasovanie. Pred čakaním na obnovenie platformy overte samotnú chybu verzie.

6. Porovnajte Workbench s podporovaným klientom

Ak je úloha naliehavá a Workbench je jediný komponent, ktorý zlyháva, reprodukujte najmenšiu požiadavku pomocou rozhrania príkazového riadka Salesforce alebo iného podporovaného a schváleného klienta. Účelom je diagnostika, nie obídenie skutočného výpadku Salesforce. Ak obaja klienti zlyhajú v rovnakej organizácii s porovnateľnými chybami na strane servera, prepnutie nástrojov pravdepodobne neobnoví službu. Ak rozhranie príkazového riadka uspeje, zatiaľ čo Workbench zlyhá, máte silnejší dôkaz, že problémom je hosting Workbenchu, relácia prehliadača alebo cesta pripojenej aplikácie.

Ilustratívny terminál zobrazujúci informácie o verzii rozhrania Salesforce CLI a úspešný príkaz na prihlásenie do organizácie cez prehliadač
Druhý klient môže pomôcť izolovať zlyhávajúcu vrstvu. Používajte schválený pracovný postup rozhrania príkazového riadka Salesforce a vyhnite sa zverejňovaniu prístupových tokenov, ID relácií alebo tajných kódov na snímkach obrazovky alebo v tiketoch.

7. Používajte disciplínu opakovaných pokusov namiesto opakovaných búrok

Počas potvrdeného prerušenia služby agresívne manuálne opakovania len zriedka pomáhajú. Pre automatizovaných klientov použite obmedzené opakovania s exponenciálnym odložením a jitterom, kde to váš integračný dizajn umožňuje. Pri manuálnom použití Workbenchu ​​počkajte na zmysluplnú aktualizáciu stavu alebo primeraný interval pred opakovaním rovnakej požiadavky.

Pri operáciách zápisu buďte obzvlášť opatrní. Časový limit nie vždy dokazuje, že Salesforce neurobil nič; klient mohol stratiť odpoveď po spracovaní požiadavky serverom. Pred opätovným odoslaním príkazu na vytvorenie, aktualizáciu, odstránenie alebo nasadenie overte, či sa pôvodná akcia potvrdila. Duplicitné zápisy sú často škodlivejšie ako oneskorený opakovaný pokus.

Bežné príznaky a ďalší postup

PríznakNajužitočnejšia ďalšia kontrolaVyhnite sa
Stránka pracovného stola sa nenačítavaSkontrolujte dostupnosť Workbenchu ​​a použite iného schváleného klientaOkamžitá zmena povolení Salesforce
Presmerovania OAuth zlyhaliSkontrolujte prihlásenie do Salesforce, dôveryhodnosť a pravidlá pre pripojené aplikácieZdieľanie ID relácií alebo poverení
REST Explorer vráti 5xxSkontrolujte dôveryhodnosť a zopakujte minimálny hovor iba na čítanie od druhého klientaSpúšťanie väčších testovacích úloh
REQUEST_LIMIT_EXCEEDEDSpotreba rozhrania API pre kontrolu organizácie a postupné limityRýchle opakovania
UNSUPPORTED_API_VERSIONVyberte verziu rozhrania API podporovanú cieľovou organizáciouČakanie na výpadok, ktorý nemusí existovať
Časový limit iba jedného zložitého dopytu vypršíZjednodušte dotaz a skontrolujte selektivitu/objemZa predpokladu výpadku celej platformy

Aké dôkazy by ste mali zhromaždiť pre pokutu za incident?

  • Časová pečiatka UTC a vaše miestne časové pásmo.
  • Identifikátory organizácie a inštancie Salesforce, ktoré je možné bezpečne zdieľať interne.
  • Presný koncový bod a metóda HTTP bez citlivých parametrov.
  • Stav HTTP, Salesforce errorCodea krátky výňatok z odpovede.
  • Či fungovalo bežné prihlásenie do Salesforce.
  • Či tá istá minimálna požiadavka zlyhala od druhého schváleného klienta.
  • Relevantné ID incidentu Salesforce Trust alebo poznámka, že nebol viditeľný žiadny zodpovedajúci incident.
  • Či bola operácia iba na čítanie alebo mohla vykonať zápis.

Nikdy nevkladajte prístupové tokeny, heslá, ID relácií, autorizačné kódy OAuth ani úplne citlivé dáta do zdieľaných tiketov alebo chatovacích kanálov.

Kedy prestať riešiť problémy s Workbenchom a prepnúť nástroje

Prepnite z Workbenchu ​​na Workbench, keď je chyba jasne izolovaná, keď je operácia príliš rozsiahla pre nástroj založený na prehliadači, keď potrebujete opakovateľné skriptované správanie alebo keď potrebujete podporovaný vývojový pracovný postup. Vlastné pokyny spoločnosti Salesforce pre nahradenie konkrétne odkazujú vývojárov na Code Builder, Salesforce CLI a Salesforce Extensions pre VS Code.

Neprepínajte nástroje len preto, aby ste neustále znižovali dostupnosť služby Salesforce. Iný klient nedokáže opraviť výpadok na strane servera a opakované volania môžu diagnostiku sťažiť. Počas výpadku je najlepším výsledkom jasná klasifikácia: potvrdený incident platformy, zlyhanie iba Workbenchu, problém s lokálnou sieťou/prehliadačom, nesúlad verzie API, problém s povoleniami/overením, vyčerpanie limitu API alebo zlyhanie špecifické pre požiadavku.

Zrátané a podčiarknuté

Chyby v Salesforce Workbench sa ľahšie riešia, keď sa k nim správate ako k signálom, nie ako k diagnózam. Skontrolujte dôveryhodnosť Salesforce, zachovajte presnú chybu, zredukujte požiadavku, porovnajte s jedným podporovaným klientom a postupujte podľa kódu chyby. Táto postupnosť vám pomôže vyhnúť sa zbytočným zmenám konfigurácie počas výpadkov a zároveň odhaliť problémy, ktoré vyzerajú ako prestoje, ale v skutočnosti sú špecifické pre nájomníka alebo Workbench.

Zanechať komentár

Doprava v Bratislave v októbri 2026: výluky vlakov, MHD, uzávierky ciest a zmeny parkovania

Doprava v Bratislave v októbri 2026: výluky vlakov, MHD, uzávierky ciest a zmeny parkovania

Prehľad potvrdených dopravných obmedzení v Bratislave na október 2026: výluka Hlavnej stanice, zmeny vlakov a MHD, parkovanie PAAS, cestné obmedzenia a informácie, ktoré sa ešte môžu zmeniť.

Bratislava v októbri 2026: kedy sú zatvorené knižnica, múzeá, pošty a mestské úrady

Bratislava v októbri 2026: kedy sú zatvorené knižnica, múzeá, pošty a mestské úrady

Overené otváracie hodiny a zatvorenia v Bratislave na október 2026: Mestská knižnica, Múzeum mesta Bratislavy, Slovenská pošta a magistrát vrátane online služieb.

Odvoz odpadu v Bratislave v októbri 2026: ako overiť termíny podľa adresy

Odvoz odpadu v Bratislave v októbri 2026: ako overiť termíny podľa adresy

Zistite, ako si v Bratislave overiť októbrový odvoz odpadu podľa adresy, čo platí pre bioodpad a objemný odpad a kam sa obrátiť pri vynechanom zvoze.

Jesenné prázdniny Bratislava 2026: dátumy, posledný deň školy a návrat

Jesenné prázdniny Bratislava 2026: dátumy, posledný deň školy a návrat

Jesenné prázdniny v Bratislave v roku 2026 trvajú 29. a 30. októbra. Zistite posledný deň vyučovania, návrat do školy, význam 28. októbra a miestne výnimky.

Výplatné termíny Sociálnej poisťovne v októbri 2026: dôchodky, nemocenské a ďalšie dávky

Výplatné termíny Sociálnej poisťovne v októbri 2026: dôchodky, nemocenské a ďalšie dávky

Overený prehľad výplatných termínov Sociálnej poisťovne na október 2026: dôchodky, nemocenské dávky, nezamestnanosť, víkendy, sviatky a postup pri omeškaní.

Výpadok Salesforce v roku 2025: Praktická retrospektíva závažných narušení

Výpadok Salesforce v roku 2025: Praktická retrospektíva závažných narušení

Preskúmajte významné výpadky Salesforce v roku 2025, čo zlyhalo, ako dlho trvali vybrané incidenty a praktické lekcie odolnosti, ktoré môžu tímy uplatniť.

Vypracovanie plánu kontinuity podnikania pre prípad prestojov v Salesforce

Vypracovanie plánu kontinuity podnikania pre prípad prestojov v Salesforce

Vytvorte praktický plán kontinuity prestojov v Salesforce s analýzou dopadov, cieľmi RTO/RPO, manuálnymi riešeniami, integračnými kontrolami a kontrolami obnovy.

Ako kontaktovať podporu Salesforce počas závažnej systémovej poruchy

Ako kontaktovať podporu Salesforce počas závažnej systémovej poruchy

Zistite, ako kontaktovať podporu Salesforce počas rozsiahleho výpadku: skontrolujte stav dôveryhodnosti, vyberte správny kanál, otvorte silný prípad a sledujte obnovu.

Chyby Salesforce Workbench: Riešenie problémov s nástrojmi API počas prestojov

Chyby Salesforce Workbench: Riešenie problémov s nástrojmi API počas prestojov

Riešenie problémov s prihlásením do Salesforce Workbench, REST Explorerom, časovým limitom, chybou 503, verziou API a obmedzenie chýb počas prestojov pomocou praktického diagnostického kontrolného zoznamu.

Má StoreForce problémy? Ako môžu maloobchodné tímy chrániť prevádzku pracovnej sily

Má StoreForce problémy? Ako môžu maloobchodné tímy chrániť prevádzku pracovnej sily

Problémy so systémom StoreForce môžu narušiť plánovanie, dodržiavanie času a pracovné postupy zamestnancov. Naučte sa, ako posúdiť vplyv, udržať prevádzku predajní, overiť obnovenie a vedieť, kedy eskalovať problém.