Salesforce Workbench -virheet: API-työkalujen vianmääritys käyttökatkon aikana

Salesforce Workbench -virheet käyttökatkon aikana: aloita erottamalla työkalun vika alustan vikaantumisesta

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 Salesforce Workbench -selainikkuna, jossa näkyy kirjautumisyhteysvirhe ilman tunnistetietojen paljastamista
Havainnollistava Workbench-yhteysvirhe. Tallenna tarkka viesti ennen asetusten muuttamista tai toistuvaa uudelleenyritystä.

Nopea triage-tarkistuslista

TarkistaMitä etsiäMitä se kertoo sinulle
Salesforce-luottamusTapahtuma-, heikkenemis-, ylläpito- tai instanssikohtainen vaikutusIlmoittaako Salesforce alustapuolen ongelmasta
Työpöytä itseVoiko kirjautumissivu latautua? Toimiiko OAuth-uudelleenohjaus oikein?Onko yhteisön ylläpitämä työkalu tavoitettavissa
Salesforce-kirjautuminenVoitko kirjautua organisaatioon normaalisti?Vaikuttaako todennus laajasti
Minimaalinen API-kutsuKokeile kevyttä päätepistettä, kuten /services/data/tai/services/data/v66.0/limitsToimiiko API-polku itsenäisesti monimutkaisesta kyselystä
Virhekoodi401, 403, 404, 5xx, aikakatkaisu, REQUEST_LIMIT_EXCEEDED,UNSUPPORTED_API_VERSIONMitä vianmäärityshaaraa seurata
Toinen asiakasSalesforce CLI, olemassa oleva integraatio tai jokin muu hyväksytty API-asiakasohjelmaOnko 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.

Havainnollistava Salesforcen luottamustilasivu, jossa on palvelurivit ja yksi korostettu häiriörivi
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.

3. Pienennä testi pienimpään turvalliseen API-pyyntöön

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.

Havainnollistava Workbench REST Explorer, joka näyttää GET-pyynnön rajapisteeseen ja API-virhevastauksen
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.

Havainnollistava päätelaite, joka näyttää Salesforce CLI -versiotiedot ja onnistuneen selainpohjaisen organisaation kirjautumiskomennon
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

OireHyödyllisin seuraava tarkistusVälttää
Työpöytäsivu ei latauduTarkista Workbenchin saavutettavuus ja käytä toista hyväksyttyä asiakasohjelmaaSalesforce-käyttöoikeuksien muuttaminen välittömästi
OAuth-uudelleenohjaukset epäonnistuvatTarkista Salesforcen kirjautumis-, luottamus- ja yhdistettyjen sovellusten käytäntöIstuntotunnusten tai tunnistetietojen jakaminen
REST Explorer palauttaa arvon 5xxTarkista Luota ja toista minimaalinen vain luku -kutsu toiselta asiakkaaltaSuurempien testitöiden suorittaminen
REQUEST_LIMIT_EXCEEDEDTarkista organisaatiorajapinnan kulutus ja liukuvat rajoituksetNopeat uudelleenyritykset
UNSUPPORTED_API_VERSIONValitse kohdeorganisaation tukema API-versioOdotetaan katkosta, jota ei ehkä ole olemassa
Vain yksi monimutkainen kysely aikakatkaistaanYksinkertaista kyselyä ja tarkista selektiivisyys/tilavuusOlettaen 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.

Jätä kommentti

Salesforcen käyttökatkos 2025: Käytännönläheinen katsaus merkittäviin häiriöihin

Salesforcen käyttökatkos 2025: Käytännönläheinen katsaus merkittäviin häiriöihin

Tarkastele merkittäviä Salesforcen käyttökatkoksia vuonna 2025, mikä epäonnistui, kuinka kauan valitut tapaukset kestivät ja käytännön vinkkejä resilienssin parantamiseksi, joita tiimit voivat soveltaa.

Liiketoiminnan jatkuvuussuunnitelman kehittäminen Salesforcen käyttökatkoksia varten

Liiketoiminnan jatkuvuussuunnitelman kehittäminen Salesforcen käyttökatkoksia varten

Rakenna käytännöllinen Salesforcen käyttökatkosten jatkuvuussuunnitelma, joka sisältää vaikutusanalyysin, RTO/RPO-tavoitteet, manuaaliset kiertotavat, integraatiokontrollit ja palautustarkistukset.

Kuinka ottaa yhteyttä Salesforce-tukeen vakavan järjestelmävian aikana

Kuinka ottaa yhteyttä Salesforce-tukeen vakavan järjestelmävian aikana

Opi ottamaan yhteyttä Salesforce-tukeen merkittävän käyttökatkoksen aikana: tarkista luottamustila, valitse oikea kanava, avaa vahva tapaus ja seuraa palautumista.

Salesforce Workbench -virheet: API-työkalujen vianmääritys käyttökatkon aikana

Salesforce Workbench -virheet: API-työkalujen vianmääritys käyttökatkon aikana

Vianmääritys Salesforce Workbench -kirjautumiseen, REST Exploreriin, aikakatkaisuun, 503-virheeseen ja API-versioon liittyen sekä käyttökatkosten aikaisten virheiden rajoittaminen käytännöllisen diagnostiikkalistan avulla.

StoreForcella ongelmia? Kuinka vähittäismyyntitiimit voivat suojata työvoiman toimintoja

StoreForcella ongelmia? Kuinka vähittäismyyntitiimit voivat suojata työvoiman toimintoja

StoreForce-ongelmat voivat häiritä aikataulutusta, työajanseurantaa ja työntekijöiden työnkulkuja. Opi arvioimaan vaikutuksia, pitämään myymälät toiminnassa, varmistamaan tilanteen korjaaminen ja tietämään, milloin asia on siirrettävä eteenpäin.

Mitkä ovat pilvialustojen laajalle levinneiden käyttökatkosten pääasialliset syyt?

Mitkä ovat pilvialustojen laajalle levinneiden käyttökatkosten pääasialliset syyt?

Ymmärrä laajalle levinneiden pilvipalvelukatkosten pääasialliset syyt, miten viat kasautuvat, mitä tarkistaa ensin ja miten suunnitella kestävämpi palautussuunnitelma.

Datorama (markkinointipilvi) ei toimi: Mitä markkinoijien on tiedettävä

Datorama (markkinointipilvi) ei toimi: Mitä markkinoijien on tiedettävä

Jos Datorama tai Marketing Cloud Intelligence vaikuttaa olevan kaatunut, käytä tätä näyttöön perustuvaa tarkistuslistaa katkoksen varmentamiseen, raportoinnin laadun suojaamiseen ja sen selvittämiseen, milloin tiedot ovat jälleen luotettavia.

Salesforce Heroku -käyttökatkos: Mitä tapahtuu käyttöönotetuille sovelluksille?

Salesforce Heroku -käyttökatkos: Mitä tapahtuu käyttöönotetuille sovelluksille?

Käytännön katsaus siihen, miten Herokun käyttökatkokset voivat vaikuttaa käyttöönotettuihin sovelluksiin, dynamiikan testaukseen, reititykseen, tietokantoihin, käyttöönottoihin, Heroku Connectiin, lokeihin ja palautukseen.

Salesforcen ja AWS:n välisen riippuvuuden ymmärtäminen

Salesforcen ja AWS:n välisen riippuvuuden ymmärtäminen

Ymmärrä, miten Salesforce ja AWS yhdistyvät Hyperforcen, integraatioiden, verkostoitumisen, datan säilytyksen, käyttökatkosten ja jaettujen operatiivisten vastuiden kautta.

Vaikuttaako viimeaikainen AWS-katkos Salesforceen? Mitä käyttäjien tulisi tarkistaa ensin

Vaikuttaako viimeaikainen AWS-katkos Salesforceen? Mitä käyttäjien tulisi tarkistaa ensin

AWS-katkos ei automaattisesti tarkoita, että Salesforce ei ole käytettävissä. Lue, miten Hyperforce, alueet, instanssit ja Salesforce Trust määrittävät, vaikuttaako se organisaatioosi.