Domov
» Správy
»
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
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í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 Salesforce
Dopad na incident, zhoršenie stavu, údržbu alebo konkrétnu inštanciu
Či Salesforce hlási problém na strane platformy
Samotný pracovný stôl
Môže sa načítať prihlasovacia stránka? Presmeruje OAuth správne?
Či je nástroj hostovaný komunitou dostupný
Prihlásenie do Salesforce
Vieš sa normálne prihlásiť do organizácie?
Či je overovanie ovplyvnené vo všeobecnosti
Minimálne volanie API
Vyskúš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
Rozhranie 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.
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.
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.
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íznak
Najužitočnejšia ďalšia kontrola
Vyhnite sa
Stránka pracovného stola sa nenačítava
Skontrolujte dostupnosť Workbenchu a použite iného schváleného klienta
Okamžitá zmena povolení Salesforce
Presmerovania OAuth zlyhali
Skontrolujte prihlásenie do Salesforce, dôveryhodnosť a pravidlá pre pripojené aplikácie
Zdieľanie ID relácií alebo poverení
REST Explorer vráti 5xx
Skontrolujte dôveryhodnosť a zopakujte minimálny hovor iba na čítanie od druhého klienta
Spúšťanie väčších testovacích úloh
REQUEST_LIMIT_EXCEEDED
Spotreba rozhrania API pre kontrolu organizácie a postupné limity
Rýchle opakovania
UNSUPPORTED_API_VERSION
Vyberte 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/objem
Za 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.