Početna
» Vijesti
»
Greške u Salesforce Workbenchu: Rješavanje problema s API alatima tijekom prekida rada
Greške u Salesforce Workbenchu: Rješavanje problema s API alatima tijekom prekida rada
Pogreške Salesforce Workbencha tijekom zastoja: počnite odvajanjem kvara alata od kvara platforme
Kada Salesforce Workbench iznenada prestane s prijavom, REST Explorer vrati grešku ili upit koji je radio prije nekoliko minuta počne istjecati, najbrži put je da ne kliknete ponovno. Prvo utvrdite koji sloj ne uspijeva: Workbench web aplikacija, vaš preglednik ili mreža, Salesforce autentifikacija, vaša specifična Salesforce instanca ili sam API zahtjev.
Ta je razlika važna jer je Workbench web-bazirani API uslužni program kojim upravlja zajednica, a ne potpuno podržani Salesforce proizvod. Salesforce izričito navodi da ne održava Workbench i preporučuje podržane alternative kao što su Salesforce CLI, Code Builder i Salesforce Extensions for Visual Studio Code. Sam projekt Workbench također opisuje alat kao alat koji zahtijeva samo održavanje. Pogledajte Salesforceove smjernice za zamjenu Workbencha i izvorni repozitorij izvornog koda Workbencha .
Koristite ovu stranicu kao praktičnu referencu kada se sumnja na prekid rada ili degradaciju usluge. Cilj je sačuvati dokaze, izbjeći nepotrebne ponovne pokušaje i odlučiti hoće li se čekati, promijeniti alate ili popraviti nešto lokalno.
Ilustrativna pogreška povezivanja s Workbenchom. Snimite točnu poruku prije promjene postavki ili ponovnog pokušaja.
Kontrolna lista za brzu trijažu
Provjeriti
Na što treba paziti
Što vam govori
Salesforce Trust
Utjecaj specifičan za incident, degradaciju, održavanje ili instancu
Prijavljuje li Salesforce problem na strani platforme
Sam radni stol
Može li se stranica za prijavu učitati? Preusmjerava li OAuth ispravno?
Je li alat koji hostira zajednica dostupan
Prijava u Salesforce
Možete li se normalno prijaviti u organizaciju?
Je li autentifikacija široko pogođena
Minimalni API poziv
Isprobajte laganu krajnju točku kao što /services/data/je ili/services/data/v66.0/limits
Radi li API put neovisno o složenom upitu
Kod pogreške
401, 403, 404, 5xx, istek vremena, REQUEST_LIMIT_EXCEEDED,UNSUPPORTED_API_VERSION
Koju granu za rješavanje problema slijediti
Drugi klijent
Salesforce CLI, postojeća integracija ili drugi odobreni API klijent
Je li kvar specifičan za Workbench
1. Provjerite Salesforce Trust prije promjene konfiguracije
Posjetite službenu stranicu za status povjerenja u Salesforceu i potražite instancu, domenu, pod ili zakupca relevantnog za vašu organizaciju. Incidenti u Salesforceu mogu biti regionalni ili specifični za instancu, tako da zeleni status za nepovezanu instancu ne dokazuje da je vaša organizacija zdrava.
Ako Trust prijavi prekid usluge, smanjenje performansi, problem s prijavom ili održavanje koje utječe na vaše okruženje, zabilježite ID i vrijeme incidenta. Zatim izbjegavajte spekulativne promjene povezanih aplikacija, vjerodajnica, profila, skupova dopuštenja, mrežnih pravila ili verzija API-ja, osim ako greška izričito ne ukazuje na te postavke. Promjene konfiguracije napravljene tijekom prekida mogu stvoriti drugi problem nakon što se platforma oporavi.
Pomoću Salesforce Trust provjerite aktivni status vlastite instance. Prikazani statusi su ilustrativni; aktivna stranica Trust je izvor istine.
2. Sačuvajte točnu Workbench grešku i klasificirajte je
Workbench često propušta odgovore na pogreške Salesforce API-ja s malo interpretacije. To je korisno za rješavanje problema: točan HTTP status, Salesforce kod pogreške, krajnja točka i poruka obično vam govore više od generičkog bannera preglednika.
Prekid veze, istek vremena ili HTTP 5xx
Istek vremena, 502, 503 ili neki drugi 5xx odgovor može biti u skladu s degradacijom usluge, preopterećenom infrastrukturom ili međukvarom mreže. Nemojte pretpostavljati da 5xx dokazuje prekid rada cijelog Salesforcea. Usporedite isti lagani zahtjev od drugog odobrenog klijenta i provjerite povjerenje. Ako više klijenata istovremeno ne uspije na istoj Salesforce instanci, dokazi ne ukazuju samo na Workbench.
Greške 401 ili nevažeće sesije
To obično ukazuje na probleme s autentifikacijom ili sesijom. Ponovno se autentificirajte pomoću OAuth umjesto kopiranja starih ID-ova sesije između preglednika. Ako normalna prijava na Salesforce također ne uspije i Trust prijavi utjecaj prijave, pričekajte oporavak usluge prije rotiranja vjerodajnica. Ako prijava na Salesforce radi, ali OAuth na Workbench ne radi, istražite put povezane aplikacije Workbench ili upotrijebite podržani alternativni klijent.
403 i pogreške autorizacije
Greška 403 obično znači da je zahtjev stigao do usluge koja ga je odbila. Provjerite korisnička dopuštenja, pravila povezanih aplikacija, ograničenja IP adresa i točan kod pogreške Salesforcea. Jedan poznati primjer specifičan za Workbench je , što se može dogoditi kada administrator blokira povezanu aplikaciju Workbench. Smjernice za povezane aplikacijeOAUTH_APP_BLOCKED projekta Workbench opisuju ovaj scenarij.
3. Smanjite test na najmanji siguran API zahtjev
Tijekom sumnje na prekid rada, nemojte dijagnosticirati skupnim učitavanjem, implementacijom metapodataka, dugim SOQL upitom ili višekoračnim skriptom. Počnite s krajnjom točkom samo za čitanje koja je jednostavna za izvršavanje. U REST Exploreru, zahtjev kao što je GET /services/data/provjerava osnovnu dostupnost API-ja. Zahtjev kao što je GET /services/data/v66.0/limitsmože vam pomoći u pregledu ograničenja organizacije kada API funkcionira.
Salesforce dokumentira Workbench REST Explorer kao način pozivanja REST krajnjih točaka, ali Workbench nije idealan za velike ili operacije koje zahtijevaju intenzivne performanse. Izvorna dokumentacija Workbencha napominje da ga vremensko ograničenje preglednika i veze čini prikladnijim za brze API interakcije u hodu nego za velika učitavanja ili izvoze podataka.
REST Explorer je koristan za minimalne reproducibilne zahtjeve. Zabilježite HTTP status i Salesforce kod pogreške umjesto da se oslanjate samo na banner poruku.
4. Tretirajte pogreške API-limita drugačije od zastoja
REQUEST_LIMIT_EXCEEDEDnije isto što i prekid rada platforme. Salesforce primjenjuje alokacije API zahtjeva i kada organizacija premaši svoje ograničenje korištenja, daljnji API pozivi mogu se blokirati dok korištenje ne padne ispod praga. Članak podrške Salesforcea iz srpnja 2026. potvrđuje da REST API, SOAP API, Bulk API i Bulk API 2.0 pozivi doprinose potrošnji API-ja. Pogledajte Salesforceove smjernice za REQUEST_LIMIT_EXCEEDED i objašnjenje ograničenja korištenja API- ja .
Ako je pogreška uvjet ograničenja, ponovljeni pokušaji pogoršavaju situaciju trošenjem više poziva kada se zahtjevi još uvijek prihvaćaju. Identificirajte integracije s velikim volumenom, pauzirajte nebitne poslove gdje je to operativno sigurno i pratite korištenje u Salesforce postavkama. Nemojte čekati incident povjerenja da biste riješili problem ograničenja specifičnog za zakupnika.
5. Provjerite neusklađenost verzije API-ja
UNSUPPORTED_API_VERSIONzaslužuje vlastitu podružnicu. Salesforce je u svibnju 2026. objavio članak podrške u kojem se objašnjava da Workbench može prema zadanim postavkama odabrati noviju verziju API-ja prije nego što je produkcijska ili razvojna organizacija podrži. Preporučeno rješenje za Workbench je snižavanje zadane verzije API-ja na onu koju podržava ciljna organizacija. Pogledajte članak o rješavanju problema UNSUPPORTED_API_VERSION u Salesforceu .
Ovo je važno tijekom razdoblja izdanja jer neusklađenost između verzije API-ja može izgledati kao prekid rada ako se usredotočite samo na vrijeme. Provjerite samu grešku verzije prije nego što pričekate oporavak platforme.
6. Usporedite Workbench s podržanim klijentom
Ako je zadatak hitan i Workbench je jedina komponenta koja ne radi, reproducirajte najmanji zahtjev pomoću Salesforce CLI-ja ili drugog podržanog, odobrenog klijenta. Svrha je dijagnostika, a ne zaobilaženje stvarnog prekida rada Salesforcea. Ako oba klijenta ne uspiju u istoj organizaciji s usporedivim pogreškama na strani poslužitelja, promjena alata vjerojatno neće vratiti uslugu. Ako CLI uspije dok Workbench ne uspije, imate jači dokaz da je problem u Workbench hostingu, sesiji preglednika ili putu povezane aplikacije.
Drugi klijent može pomoći u izolaciji sloja koji ne uspijeva. Koristite odobreni Salesforce CLI tijek rada i izbjegavajte otkrivanje pristupnih tokena, ID-ova sesija ili tajni na snimkama zaslona ili tiketima.
7. Koristite disciplinu ponovnog pokušaja umjesto oluja ponovnih pokušaja
Tijekom potvrđenog prekida usluge, agresivni ručni ponovni pokušaji rijetko pomažu. Za automatizirane klijente koristite ograničene ponovne pokušaje s eksponencijalnim odmakom i podrhtavanjem gdje to dopušta vaš dizajn integracije. Za ručnu upotrebu Workbencha pričekajte smisleno ažuriranje statusa ili razuman interval prije ponavljanja istog zahtjeva.
Za operacije pisanja budite posebno oprezni. Istek vremena ne dokazuje uvijek da Salesforce nije ništa učinio; klijent je možda izgubio odgovor nakon što je poslužitelj obradio zahtjev. Prije ponovnog slanja naredbe za kreiranje, ažuriranje, brisanje ili implementaciju, provjerite je li izvorna radnja izvršena. Dvostruki zapisi često su štetniji od odgođenog ponovnog pokušaja.
Uobičajeni simptomi i sljedeće radnje
Simptom
Najkorisnija sljedeća provjera
Izbjegavati
Stranica Workbencha se ne učitava
Provjerite dostupnost Workbencha i koristite drugog odobrenog klijenta
Trenutna promjena dozvola Salesforcea
OAuth preusmjeravanja ne uspijevaju
Provjerite prijavu u Salesforce, povjerenje i pravila za povezane aplikacije
Dijeljenje ID-ova sesija ili vjerodajnica
REST Explorer vraća 5xx
Provjeri povjerenje i ponovi minimalni poziv samo za čitanje od drugog klijenta
Izvođenje većih testnih zadataka
REQUEST_LIMIT_EXCEEDED
Pregledajte potrošnju API-ja organizacije i ograničenja korištenja
Brzi ponovni pokušaji
UNSUPPORTED_API_VERSION
Odaberite verziju API-ja koju podržava ciljna organizacija
Čekanje prekida koji možda i ne postoji
Samo jedan složeni upit ima vremenski limit
Pojednostavite upit i provjerite selektivnost/volumen
Pretpostavimo zastoj na cijeloj platformi
Koje dokaze trebate prikupiti za prijavu incidenta?
UTC vremenska oznaka i vaša lokalna vremenska zona.
Identifikatori Salesforce organizacije i instance koji se mogu sigurno dijeliti interno.
Točna krajnja točka i HTTP metoda, s uklonjenim osjetljivim parametrima.
Je li funkcionirala normalna prijava na Salesforce.
Je li isti minimalni zahtjev odbijen od drugog odobrenog klijenta.
Relevantni ID incidenta Salesforce Trust ili napomena da nije vidljiv nijedan odgovarajući incident.
Je li operacija bila samo za čitanje ili je mogla potvrditi pisanje.
Nikada nemojte lijepiti tokene za pristup, lozinke, ID-ove sesija, OAuth autorizacijske kodove ili potpuno osjetljive podatke u dijeljene tikete ili chat kanale.
Kada prestati s rješavanjem problema na radnom stolu i promijeniti alate
Prebacite se s Workbencha na Workbench kada je kvar očito izoliran, kada je operacija prevelika za uslužni program temeljen na pregledniku, kada vam je potrebno ponovljivo skriptirano ponašanje ili kada vam je potreban podržani razvojni tijek rada. Salesforceove vlastite smjernice za zamjenu posebno upućuju programere na Code Builder, Salesforce CLI i Salesforce Extensions za VS Code.
Nemojte mijenjati alate samo da biste nastavili opterećivati nedostupnu Salesforce uslugu. Drugi klijent ne može popraviti prekid rada na strani poslužitelja, a ponovljeni pozivi mogu učiniti dijagnozu bučnijom. Tijekom prekida rada, najbolji rezultat je jasna klasifikacija: potvrđeni incident platforme, kvar samo na Workbenchu, problem s lokalnom mrežom/preglednikom, neusklađenost verzije API-ja, problem s dozvolama/autentifikacijom, iscrpljivanje ograničenja API-ja ili kvar specifičan za zahtjev.
Zaključak
Pogreške u Salesforce Workbenchu lakše je riješiti kada ih tretirate kao signale, a ne kao dijagnoze. Provjerite Salesforce Trust, sačuvajte točnu pogrešku, smanjite zahtjev, usporedite s jednim podržanim klijentom i slijedite kod pogreške. Taj slijed vam pomaže da izbjegnete nepotrebne promjene konfiguracije tijekom prekida, a istovremeno uočavate probleme koji izgledaju kao prekid rada, ali su zapravo specifični za zakupnika ili Workbench.