Kun Salesforce Workbench lakkaa yhtäkkiä kirjautumasta sisään, REST Explorer palauttaa virheen tai minuutteja sitten toiminut kysely alkaa aikakatkaista, nopein tapa on olla napsauttamatta Yritä uudelleen -painiketta jatkuvasti. Selvitä ensin, mikä taso epäonnistuu: Workbench-verkkosovellus, selaimesi tai verkkosi, Salesforce-todennus, tietty Salesforce-instanssisi vai itse API-pyyntö.
Tällä erolla on merkitystä, koska Workbench on yhteisön ylläpitämä, verkkopohjainen API-apuohjelma eikä täysin tuettu Salesforce-tuote. Salesforce sanoo nimenomaisesti, ettei se ylläpidä Workbenchiä ja suosittelee tuettuja vaihtoehtoja, kuten Salesforce CLI:tä, Code Builderia ja Salesforce Extensions for Visual Studio Codea. Itse Workbench-projekti kuvailee työkalua myös vain ylläpitoa vaativaksi. Katso Salesforcen Workbenchin korvausohjeet ja alkuperäinen Workbenchin lähdekoodiarkisto .
Käytä tätä sivua käytännön apuvälineenä, kun epäilet käyttökatkosta tai palvelun heikentymistä. Tavoitteena on säilyttää todisteet, välttää tarpeettomia uudelleenyrityksiä ja päättää, kannattaako odottaa, vaihtaa työkaluja vai korjata jokin paikallinen vika.
Havainnollistava Workbench-yhteysvirhe. Tallenna tarkka viesti ennen asetusten muuttamista tai toistuvaa uudelleenyritystä.
Nopea triage-tarkistuslista
Tarkista
Mitä etsiä
Mitä se kertoo sinulle
Salesforce-luottamus
Tapahtuma-, heikkenemis-, ylläpito- tai instanssikohtainen vaikutus
Salesforce CLI, olemassa oleva integraatio tai jokin muu hyväksytty API-asiakasohjelma
Onko vika Workbench-kohtainen
1. Tarkista Salesforcen luotettavuus ennen määritysten muuttamista
Siirry Salesforcen viralliselle luottamustilan sivustolle ja hae organisaatioosi liittyvää instanssia, toimialuetta, podia tai vuokraajaa. Salesforce-tapaukset voivat olla alueellisia tai instanssikohtaisia, joten vihreä tila toiselle instanssille ei todista, että organisaatiosi on terve.
Jos Trust raportoi palveluhäiriöstä, suorituskyvyn heikkenemisestä, kirjautumisongelmasta tai ympäristöösi vaikuttavasta huollosta, kirjaa tapahtumatunnus ja aika. Vältä sitten spekulatiivisten muutosten tekemistä yhdistettyihin sovelluksiin, tunnistetietoihin, profiileihin, käyttöoikeusjoukkoihin, verkkokäytäntöihin tai API-versioihin, ellei virhe viittaa nimenomaisesti näihin asetuksiin. Katkoksen aikana tehdyt määritysmuutokset voivat aiheuttaa toisen ongelman alustan palautumisen jälkeen.
Käytä Salesforce Trustia vahvistaaksesi oman instanssisi live-tilan. Tässä näkyvät tilat ovat havainnollistavia; live-luottamussivu on totuuden lähde.
2. Säilytä tarkka Workbench-virhe ja luokittele se
Workbench usein välittää Salesforce API -virhevastaukset läpi lähes tulkittuna. Tämä on hyödyllistä vianmäärityksessä: tarkka HTTP-tila, Salesforce-virhekoodi, päätepiste ja viesti kertovat yleensä enemmän kuin yleinen selainbanneri.
Yhteysvirhe, aikakatkaisu tai HTTP 5xx
Aikakatkaisu, 502, 503 tai muu 5xx-vastaus voi viitata palvelun heikkenemiseen, ylikuormitettuun infrastruktuuriin tai verkon vikaantumiseen. Älä oleta, että 5xx todistaa koko Salesforcen laajuisen käyttökatkoksen. Vertaa samaa kevyttä pyyntöä toiselta hyväksytyltä asiakkaalta ja tarkista luotettavuus. Jos useat asiakkaat epäonnistuvat samaa Salesforce-instanssia vastaan samanaikaisesti, todisteet viittaavat muualle kuin Workbench.
401-virheet tai virheellisen istunnon virheet
Nämä viittaavat yleensä todennus- tai istunto-ongelmiin. Suorita todennus uudelleen OAuthilla sen sijaan, että kopioisit vanhoja istuntotunnuksia selainten välillä. Jos normaali Salesforce-kirjautuminen epäonnistuu myös ja Trust raportoi kirjautumisen vaikutuksesta, odota palvelun palautumista ennen tunnistetietojen kierrättämistä. Jos Salesforce-kirjautuminen toimii, mutta Workbench OAuth ei, tutki Workbenchin yhdistetyn sovelluksen polkua tai käytä tuettua vaihtoehtoista asiakasohjelmaa.
403- ja valtuutusvirheet
403-virhe tarkoittaa yleensä, että pyyntö saavutti palvelun, joka hylkäsi sen. Tarkista käyttäjäoikeudet, yhdistetyn sovelluksen käytäntö, IP-rajoitukset ja tarkka Salesforce-virhekoodi. Yksi tunnettu Workbench-kohtainen esimerkki on OAUTH_APP_BLOCKED, joka voi ilmetä, kun järjestelmänvalvoja estää Workbench-yhdistetyn sovelluksen. Workbench-projektin yhdistettyjen sovellusten ohjeistus kuvaa tämän skenaarion.
Epäillyn käyttökatkoksen aikana älä käytä massalatausta, metatietojen käyttöönottoa, pitkää SOQL-kyselyä tai monivaiheista skriptiä. Aloita vain luku -tilassa olevalla päätepisteellä, jonka suorittaminen on edullista. REST Explorerissa pyyntö, kuten , GET /services/data/tarkistaa API:n perussaavutettavuuden. Tällainen pyyntö GET /services/data/v66.0/limitsvoi auttaa sinua tarkastamaan organisaation rajoituksia, kun API toimii.
Salesforce dokumentoi Workbench REST Explorerin tapana kutsua REST-päätepisteitä, mutta Workbench ei ole ihanteellinen suurille tai suorituskykyintensiivisille toiminnoille. Alkuperäisessä Workbenchin dokumentaatiossa todetaan, että selaimen ja yhteyden aikakatkaisut tekevät siitä paremmin sopivan nopeisiin, reaaliaikaisiin API-vuorovaikutuksiin kuin suuriin datan lataus- tai vientimenetelmiin.
REST Explorer on hyödyllinen minimaalisesti toistettavissa pyynnöissä. Tallenna HTTP-tila ja Salesforce-virhekoodi pelkän banneriviestin perusteella.
4. Käsittele API-rajoitusvirheitä eri tavalla kuin käyttökatkoksia
REQUEST_LIMIT_EXCEEDEDei ole sama asia kuin alustan käyttökatkos. Salesforce käyttää API-pyyntöjen allokointeja, ja kun organisaatio ylittää liukuvan käyttörajansa, lisä API-kutsuja voidaan estää, kunnes käyttö laskee kynnyksen alapuolelle. Salesforcen heinäkuun 2026 tukiartikkeli vahvistaa, että REST API-, SOAP API-, Bulk API- ja Bulk API 2.0 -kutsujen käyttö vaikuttaa kaikki API-kulutukseen. Katso Salesforcen ohjeet REQUEST_LIMIT_EXCEEDED-arvolle ja sen liukuvan API-rajoituksen selitykselle .
Jos virhe on rajaehto, toistuvat uudelleenyritykset pahentavat tilannetta kuluttamalla enemmän kutsuja, kun pyyntöjä vielä hyväksytään. Tunnista suuren volyymin integraatiot, keskeytä ei-välttämättömät työt, jos se on toiminnallisesti turvallista, ja valvo käyttöä Salesforce-asetuksissa. Älä odota luottamustapausta ratkaistaksesi vuokraajakohtaisen rajoitusongelman.
5. Tarkista API-versioiden yhteensopimattomuus
UNSUPPORTED_API_VERSIONansaitsee oman haaransa. Salesforce julkaisi toukokuussa 2026 tukiartikkelin, jossa selitettiin, että Workbench voi oletusarvoisesti käyttää uudempaa API-versiota ennen kuin tuotanto- tai Developer Edition -organisaatio tukee sitä. Suositeltu Workbench-korjaus on alentaa oletus-API-versio kohdeorganisaation tukemaan versioon. Katso Salesforcen UNSUPPORTED_API_VERSION-vianmääritysartikkeli .
Tällä on merkitystä julkaisuikkunoiden aikana, koska API-versioiden yhteensopimattomuus voi näyttää käyttökatkokselta, jos keskityt vain ajoitukseen. Tarkista itse versiovirhe ennen kuin odotat alustan palautumista.
6. Vertaa Workbenchiä tuettuun asiakasohjelmaan
Jos tehtävä on kiireellinen ja Workbench on ainoa viallinen komponentti, toista pienin pyyntö Salesforce CLI:n tai muun tuetun, hyväksytyn asiakasohjelman avulla. Tarkoitus on diagnoosi, ei aidon Salesforce-käyttökatkoksen ohittaminen. Jos molemmat asiakasohjelmat epäonnistuvat samassa organisaatiossa vertailukelpoisten palvelinpuolen virheiden vuoksi, työkalujen vaihtaminen ei todennäköisesti palauta palvelua. Jos CLI onnistuu, kun taas Workbench epäonnistuu, sinulla on vahvempia todisteita siitä, että Workbenchin hosting, selainistunto tai yhdistetyn sovelluksen polku on ongelma.
Toinen asiakasohjelma voi auttaa eristämään epäonnistuvan tason. Käytä hyväksyttyä Salesforce CLI -työnkulkua ja vältä käyttöoikeustunnusten, istuntotunnusten tai salaisuuksien paljastamista kuvakaappauksissa tai tiketeissä.
7. Käytä uudelleenyrityskuria uudelleenyritysmyrskyjen sijaan
Vahvistetun palveluhäiriön aikana aggressiiviset manuaaliset uudelleenyritykset harvoin auttavat. Automatisoitujen asiakkaiden kanssa käytä rajoitettuja uudelleenyrityksiä eksponentiaalisella peruutuksella ja jitterillä, jos integraatiosuunnittelusi sen sallii. Manuaalisessa Workbench-käytössä odota merkityksellistä tilapäivitystä tai kohtuullista aikaa ennen saman pyynnön toistamista.
Kirjoitustoimintojen kanssa on oltava erityisen varovainen. Aikakatkaisu ei aina todista, että Salesforce ei tehnyt mitään; asiakas on saattanut kadottaa vastauksen palvelimen käsiteltyä pyynnön. Ennen kuin lähetät luonti-, päivitys-, poisto- tai käyttöönottopyynnön uudelleen, tarkista, onko alkuperäinen toiminto suoritettu. Kaksoiskirjoitukset ovat usein vahingollisempia kuin viivästynyt uudelleenyritys.
Yleiset oireet ja seuraavat toimenpiteet
Oire
Hyödyllisin seuraava tarkistus
Välttää
Työpöytäsivu ei lataudu
Tarkista Workbenchin saavutettavuus ja käytä toista hyväksyttyä asiakasohjelmaa
Salesforce-käyttöoikeuksien muuttaminen välittömästi
OAuth-uudelleenohjaukset epäonnistuvat
Tarkista Salesforcen kirjautumis-, luottamus- ja yhdistettyjen sovellusten käytäntö
Istuntotunnusten tai tunnistetietojen jakaminen
REST Explorer palauttaa arvon 5xx
Tarkista Luota ja toista minimaalinen vain luku -kutsu toiselta asiakkaalta
Suurempien testitöiden suorittaminen
REQUEST_LIMIT_EXCEEDED
Tarkista organisaatiorajapinnan kulutus ja liukuvat rajoitukset
Nopeat uudelleenyritykset
UNSUPPORTED_API_VERSION
Valitse kohdeorganisaation tukema API-versio
Odotetaan katkosta, jota ei ehkä ole olemassa
Vain yksi monimutkainen kysely aikakatkaistaan
Yksinkertaista kyselyä ja tarkista selektiivisyys/tilavuus
Olettaen koko alustan seisokkiaikaa
Mitä todisteita sinun tulisi kerätä onnettomuuslipuketta varten?
UTC-aikaleima ja paikallinen aikavyöhykkeesi.
Salesforce-organisaation ja -instanssin tunnisteet, jotka on turvallista jakaa sisäisesti.
Tarkka päätepiste ja HTTP-metodi, josta on poistettu arkaluontoiset parametrit.
HTTP-tila, Salesforce errorCodeja lyhyt vastauksen ote.
Toimiko normaali Salesforce-kirjautuminen.
Epäonnistuiko sama minimaalinen pyyntö toiselta hyväksytyltä asiakkaalta.
Asiaankuuluva Salesforce Trust -tapauksen tunnus tai huomautus, ettei vastaavaa tapausta näkynyt.
Oliko toiminto vain luku -tilassa vai olisiko siihen voitu tehdä kirjoitus.
Älä koskaan liitä käyttöoikeustunnuksia, salasanoja, istuntotunnuksia, OAuth-valtuutuskoodeja tai kokonaisia arkaluonteisia hyötykuormia jaettuihin tiketteihin tai keskustelukanaviin.
Milloin lopettaa Workbenchin ja vaihtotyökalujen vianmääritys
Siirry pois Workbenchistä, kun vika on selvästi rajattu Workbenchiin, kun operaatio on liian suuri selainpohjaiselle apuohjelmalle, kun tarvitset toistettavaa komentosarjojen toimintaa tai kun tarvitset tuetun kehitystyönkulun. Salesforcen omat korvaavat ohjeet ohjaavat kehittäjiä erityisesti Code Builderiin, Salesforce CLI:hen ja Salesforce Extensions for VS Codeen.
Älä vaihda työkaluja vain jatkaaksesi käyttämättömän Salesforce-palvelun mollaamista. Eri asiakas ei voi korjata palvelinpuolen käyttökatkosta, ja toistuvat pyynnöt voivat tehdä diagnoosista meluisampaa. Käyttökatkoksen aikana paras tulos on selkeä luokittelu: vahvistettu alustahäiriö, vain Workbench-käyttöjärjestelmän vika, paikallisverkon/selaimen ongelma, API-versioiden yhteensopimattomuus, käyttöoikeus-/todennusongelma, API-rajoituksen umpeutuminen tai pyyntökohtainen vika.
Lopputulos
Salesforce Workbench -virheitä on helpompi käsitellä, kun niitä käsitellään signaaleina, ei diagnooseina. Tarkista Salesforcen luotettavuus, tallenna tarkka virhe, pienennä pyyntöä, vertaa yhteen tuettuun asiakkaaseen ja noudata virhekoodia. Tämä auttaa välttämään tarpeettomia määritysmuutoksia käyttökatkosten aikana ja samalla havaitsemaan ongelmia, jotka näyttävät käyttökatkoksilta, mutta ovat todellisuudessa vuokraaja- tai Workbench-kohtaisia.