Salesforce Workbench-fel: Felsökning av API-verktyg under driftstopp

Salesforce Workbench-fel under driftstopp: börja med att separera verktygsfel från plattformsfel

När Salesforce Workbench plötsligt slutar logga in, REST Explorer returnerar ett fel, eller en fråga som fungerade för några minuter sedan börjar få tidsgränsen, är det snabbaste sättet att inte klicka på "Försök igen" hela tiden. Bestäm först vilket lager som misslyckas: Workbench-webbappen, din webbläsare eller ditt nätverk, Salesforce-autentisering, din specifika Salesforce-instans eller själva API-begäran.

Den skillnaden är viktig eftersom Workbench är ett community-underhållet, webbaserat API-verktyg snarare än en fullt stödd Salesforce-produkt. Salesforce säger uttryckligen att de inte underhåller Workbench och rekommenderar stödda alternativ som Salesforce CLI, Code Builder och Salesforce Extensions för Visual Studio Code. Själva Workbench-projektet beskriver också verktyget som endast underhållsbaserat. Se Salesforces riktlinjer för ersättning av Workbench och den ursprungliga Workbench-källkodsförteckningen .

Använd den här sidan som en praktisk referens när man misstänker ett avbrott eller en försämrad tjänst. Målet är att bevara bevis, undvika onödiga omförsök och avgöra om man ska vänta, byta verktyg eller åtgärda något lokalt.

Illustrativt Salesforce Workbench-webbläsarfönster som visar ett inloggningsfel utan att exponera autentiseringsuppgifter
Illustrativt anslutningsfel för arbetsbänken. Avbilda det exakta meddelandet innan du ändrar inställningar eller försöker upprepade gånger.

Snabb triagechecklista

KontrolleraVad man ska leta efterVad det säger dig
Salesforce TrustIncident-, försämrings-, underhålls- eller instansspecifik påverkanHuruvida Salesforce rapporterar ett problem på plattformssidan
Själva arbetsbänkenKan inloggningssidan laddas? Omdirigerar OAuth korrekt?Om det community-hostade verktyget är tillgängligt
Salesforce-inloggningKan du logga in på organisationen normalt?Huruvida autentisering påverkas i stor utsträckning
Minimalt API-anropProva en lättviktig slutpunkt som /services/data/eller/services/data/v66.0/limitsOm API-sökvägen fungerar oberoende av en komplex fråga
Felkod401, 403, 404, 5xx, timeout, REQUEST_LIMIT_EXCEEDED,UNSUPPORTED_API_VERSIONVilken felsökningsgren ska följas
Andra klientenSalesforce CLI, en befintlig integration eller en annan godkänd API-klientOm felet är specifikt för Workbench

1. Kontrollera Salesforce Trust innan du ändrar din konfiguration

Gå till den officiella webbplatsen för Salesforce Trust-status och sök efter den instans, domän, pod eller hyresgäst som är relevant för din organisation. Salesforce-incidenter kan vara regionala eller instansspecifika, så en grön status för en orelaterad instans bevisar inte att din organisation är felfri.

Om Trust rapporterar ett avbrott i tjänsten, prestandaförsämring, inloggningsproblem eller underhåll som påverkar din miljö, registrera incident-ID och tidpunkt. Undvik sedan att göra spekulativa ändringar i anslutna appar, autentiseringsuppgifter, profiler, behörighetsuppsättningar, nätverkspolicyer eller API-versioner om inte felet specifikt pekar på dessa inställningar. Konfigurationsändringar som görs under ett avbrott kan skapa ett andra problem efter att plattformen återställts.

Illustrativ Salesforce Trust-statussida med servicerader och en markerad störningsrad
Använd Salesforce Trust för att bekräfta livestatusen för din egen instans. Statusen som visas här är illustrativ; live-sidan Trust är källan till sanningen.

2. Bevara det exakta Workbench-felet och klassificera det

Workbench skickar ofta igenom Salesforce API-felsvar med liten tolkning. Det är användbart för felsökning: den exakta HTTP-statusen, Salesforce-felkoden, slutpunkten och meddelandet säger vanligtvis mer än en generisk webbläsarbanner.

Anslutningsfel, timeout eller HTTP 5xx

En timeout, 502, 503 eller annan 5xx-respons kan vara förenlig med tjänsteförsämring, överbelastad infrastruktur eller ett mellanliggande nätverksfel. Anta inte att en 5xx bevisar ett Salesforce-omfattande avbrott. Jämför samma lättviktsbegäran från en annan godkänd klient och kontrollera förtroendet. Om flera klienter misslyckas mot samma Salesforce-instans samtidigt pekar bevisen bort från enbart Workbench.

401- eller ogiltiga sessionsfel

Dessa tyder generellt på autentiserings- eller sessionsproblem. Autentisera igen med OAuth istället för att kopiera gamla sessions-ID:n mellan webbläsare. Om normal Salesforce-inloggning också misslyckas och Trust rapporterar inloggningspåverkan, vänta på tjänståterställning innan du roterar autentiseringsuppgifter. Om Salesforce-inloggning fungerar men Workbench OAuth inte gör det, undersök sökvägen för Workbench-anslutna appen eller använd en alternativ klient som stöds.

403 och auktoriseringsfel

Ett 403-fel betyder vanligtvis att begäran nådde en tjänst som avvisade den. Kontrollera användarbehörigheter, policy för anslutna appar, IP-begränsningar och den exakta Salesforce-felkoden. Ett känt Workbench-specifikt exempel är OAUTH_APP_BLOCKED, vilket kan inträffa när en administratör blockerar den anslutna Workbench-appen. Workbench-projektets vägledning för anslutna appar beskriver detta scenario.

3. Reducera testet till den minsta säkra API-förfrågan

Under ett misstänkt avbrott, diagnostisera inte med en bulkbelastning, metadatadistribution, lång SOQL-fråga eller flerstegsskript. Börja med en skrivskyddad slutpunkt som är billig att köra. I REST Explorer GET /services/data/kontrollerar en begäran som grundläggande API-nåbarhet. En begäran som GET /services/data/v66.0/limitskan hjälpa dig att inspektera organisationsgränser när API:et fungerar.

Salesforce dokumenterar Workbench REST Explorer som ett sätt att anropa REST-slutpunkter, men Workbench är inte idealiskt för stora eller prestandakrävande operationer. Den ursprungliga Workbench-dokumentationen noterar att timeouts för webbläsare och anslutningar gör den bättre lämpad för snabba API-interaktioner i realtid än stora datainläsningar eller exporter.

Illustrativ Workbench REST Explorer som visar en GET-begäran till limits-slutpunkten och ett API-felsvar
REST Explorer är användbart för en minimalt reproducerbar begäran. Registrera HTTP-status och Salesforce-felkoden istället för att bara förlita sig på bannermeddelandet.

4. Hantera API-gränsfel annorlunda än driftstopp

REQUEST_LIMIT_EXCEEDEDär inte samma sak som ett plattformsavbrott. Salesforce tillämpar API-förfrågningsallokeringar, och när en organisation överskrider sin rullande användningsgräns kan ytterligare API-anrop blockeras tills användningen sjunker under tröskeln. Salesforces supportartikel från juli 2026 bekräftar att REST API-, SOAP API-, Bulk API- och Bulk API 2.0-anrop alla bidrar till API-förbrukning. Se Salesforces vägledning för REQUEST_LIMIT_EXCEEDED och dess förklaring av rullande API-gränser .

Om felet är ett gränsvillkor förvärrar upprepade försök situationen genom att förbruka fler anrop när förfrågningar fortfarande accepteras. Identifiera integrationer med hög volym, pausa icke-nödvändiga jobb där det är driftsäkert och övervaka användningen i Salesforce-installationen. Vänta inte på en förtroendeincident för att lösa ett hyresgästspecifikt gränsproblem.

5. Kontrollera om det finns en API-versionsmatchning

UNSUPPORTED_API_VERSIONförtjänar en egen gren. Salesforce publicerade en supportartikel i maj 2026 som förklarade att Workbench kan använda en nyare API-version som standard innan en produktions- eller Developer Edition-organisation stöder den. Den rekommenderade Workbench-åtgärden är att sänka standard-API-versionen till en som stöds av målorganisationen. Se Salesforces felsökningsartikel UNSUPPORTED_API_VERSION .

Detta är viktigt under utgivningsfönster eftersom en API-versionsmatchning kan se ut som ett avbrott om du bara fokuserar på tidpunkten. Verifiera själva versionsfelet innan du väntar på plattformsåterställning.

6. Jämför Workbench med en klient som stöds

Om uppgiften är brådskande och Workbench är den enda komponenten som misslyckas, reproducera den minsta begäran med Salesforce CLI eller en annan klient som stöds och godkänts. Syftet är diagnos, inte att kringgå ett genuint Salesforce-avbrott. Om båda klienterna misslyckas mot samma organisation med jämförbara fel på serversidan, är det osannolikt att det återställer tjänsten att byta verktyg. Om CLI lyckas medan Workbench misslyckas, har du starkare bevis för att Workbench-värdskapet, webbläsarsessionen eller sökvägen till den anslutna appen är problemet.

Illustrativ terminal som visar Salesforce CLI-versionsinformation och ett lyckat webbläsarbaserat organisationsinloggningskommando
En andra klient kan hjälpa till att isolera det felaktiga lagret. Använd ett godkänt Salesforce CLI-arbetsflöde och undvik att exponera åtkomsttokens, sessions-ID:n eller hemligheter i skärmdumpar eller ärenden.

7. Använd disciplin för återförsök istället för återförsöksstormar

Under ett bekräftat avbrott i tjänsten hjälper aggressiva manuella försök sällan. För automatiserade klienter, använd begränsade försök med exponentiell backoff och jitter där din integrationsdesign tillåter det. För manuell användning i Workbench, vänta på en meningsfull statusuppdatering eller ett rimligt intervall innan du upprepar samma begäran.

Var särskilt försiktig vid skrivåtgärder. En timeout bevisar inte alltid att Salesforce inte gjorde någonting; klienten kan ha förlorat svaret efter att servern bearbetade begäran. Innan du skickar in en ny åtgärd för att skapa, uppdatera, ta bort eller distribuera, kontrollera om den ursprungliga åtgärden har utförts. Dubbletter av skrivningar är ofta mer skadliga än ett fördröjt försök.

Vanliga symtom och nästa åtgärd

SymptomMest användbar nästa kontrollUndvika
Workbench-sidan laddas inteKontrollera Workbench-åtkomligheten och använd en annan godkänd klientÄndra Salesforce-behörigheter omedelbart
OAuth-omdirigeringar misslyckasKontrollera Salesforce inloggning, förtroende och policy för anslutna apparDela sessions-ID:n eller inloggningsuppgifter
REST Explorer returnerar 5xxKontrollera förtroendet och upprepa ett minimalt skrivskyddat anrop från en andra klientKöra större testjobb
REQUEST_LIMIT_EXCEEDEDGranska organisationens API-förbrukning och rullande gränserSnabba återförsök
UNSUPPORTED_API_VERSIONVälj en API-version som stöds av målorganisationenVäntar på ett avbrott som kanske inte existerar
Endast en komplex fråga har timeoutFörenkla frågan och inspektera selektivitet/volymFörutsatt plattformsomfattande driftstopp

Vilka bevis bör man samla in för en incidentböter?

  • UTC-tidsstämpel och din lokala tidszon.
  • Salesforce-organisations- och instansidentifierare som är säkra att dela internt.
  • Den exakta slutpunkten och HTTP-metoden, med känsliga parametrar borttagna.
  • HTTP-status, Salesforce errorCodeoch ett kort svarsutdrag.
  • Om vanlig Salesforce-inloggning fungerade.
  • Huruvida samma minimala begäran misslyckades från en andra godkänd klient.
  • Relevant Salesforce Trust-incident-ID eller en anteckning om att ingen matchande incident var synlig.
  • Om åtgärden var skrivskyddad eller kunde ha utfört en skrivning.

Klistra aldrig in åtkomsttokens, lösenord, sessions-ID:n, OAuth-auktoriseringskoder eller fullständiga känsliga nyttolaster i delade ärenden eller chattkanaler.

När man ska sluta felsöka Workbench och byta verktyg

Växla från Workbench när felet är tydligt isolerat till Workbench, när operationen är för stor för ett webbläsarbaserat verktyg, när du behöver repeterbart skriptbeteende eller när du behöver ett utvecklingsarbetsflöde som stöds. Salesforces egna ersättningsriktlinjer hänvisar specifikt utvecklare till Code Builder, Salesforce CLI och Salesforce Extensions för VS Code.

Byt inte verktyg bara för att fortsätta att pressa på en otillgänglig Salesforce-tjänst. En annan klient kan inte åtgärda ett serveravbrott, och upprepade anrop kan göra diagnosen mer bullrig. Under driftstopp är det bästa resultatet en tydlig klassificering: bekräftad plattformsincident, fel endast på Workbench, problem med lokalt nätverk/webbläsare, API-versionsmatchning som inte matchar, behörighets-/autentiseringsproblem, API-gränsutmattning eller förfrågningsspecifikt fel.

Slutsats

Salesforce Workbench-fel är enklare att hantera när du behandlar dem som signaler, inte diagnoser. Kontrollera Salesforce Trust, bevara det exakta felet, minska antalet begäranden, jämför med en klient som stöds och följ felkoden. Den sekvensen hjälper dig att undvika onödiga konfigurationsändringar under avbrott samtidigt som du upptäcker problem som ser ut som driftstopp men som i själva verket är hyresgästspecifika eller Workbench-specifika.

Lämna en kommentar

Windows 11: Så hanterar du vanliga uppdaterings- och prestandaproblem

Windows 11: Så hanterar du vanliga uppdaterings- och prestandaproblem

Windows 11 som inte uppdateras eller känns långsamt? Följ åtta steg för felsökning, lagringsrensning och systemreparation och kontrollera resultatet.

One UI 9: nya funktioner, kompatibla Galaxy-enheter och uppdatering

One UI 9: nya funktioner, kompatibla Galaxy-enheter och uppdatering

Läs om nyheterna i One UI 9, vilka Galaxy-modeller Samsung bekräftat och hur du söker efter och installerar uppdateringen.

Britax Römer BABY-SAFE PRO: kontrollera säkerhet, passform och montering

Britax Römer BABY-SAFE PRO: kontrollera säkerhet, passform och montering

Så kontrollerar du BABY-SAFE PRO:s skick, barnets mått, bil- och baskompatibilitet samt korrekt montering med ISOFIX-bas eller bilbälte.

Sophämtning i Stockholm i oktober 2026: hämtdagar, helgöppet och extra avfall

Sophämtning i Stockholm i oktober 2026: hämtdagar, helgöppet och extra avfall

Så hittar du rätt hämtdag för din adress i Stockholm i oktober 2026, vad Alla helgons dag påverkar och var du lämnar extra eller missat avfall.

Öppettider och stängningar i Stockholm i oktober 2026: bibliotek, museer, post och kommunal service

Öppettider och stängningar i Stockholm i oktober 2026: bibliotek, museer, post och kommunal service

Praktisk guide till öppettider och stängningar i Stockholm i oktober 2026, inklusive Alla helgons dag, Stadsbibliotekets renovering, museer, PostNord och kommunal service.

Trafikstörningar i Stockholm i oktober 2026: avstängningar, banarbeten och smarta alternativ

Trafikstörningar i Stockholm i oktober 2026: avstängningar, banarbeten och smarta alternativ

Planera resor i Stockholm i oktober 2026 med verifierade uppgifter om pendeltåg, Saltsjöbanan, bussar, vägarbeten, Hornsgatan, parkering och information som ännu kan ändras.

Pensionsmyndighetens utbetalningsdatum i oktober 2026: pension den 19 oktober

Pensionsmyndighetens utbetalningsdatum i oktober 2026: pension den 19 oktober

Pensionsmyndighetens pension betalas ut måndag 19 oktober 2026 för båda födelsedagsgrupperna. Se helgregeln, berörda stöd, kontroller och vad du gör om pengarna saknas.

Höstlov i Stockholm oktober 2026: sista skoldagen, lovdatum och skolstart igen

Höstlov i Stockholm oktober 2026: sista skoldagen, lovdatum och skolstart igen

Bekräftade skollov och stängningsdagar i Stockholm i oktober 2026: sista skoldag 23 oktober, höstlov 26–30 oktober, Alla helgons dag och lokala studiedagar.

Så fungerar BankID: säker användning och lösningar på vanliga problem

Så fungerar BankID: säker användning och lösningar på vanliga problem

Lär dig hur BankID fungerar, vad du bör kontrollera före en inloggning och hur du löser vanliga problem med app, QR-kod och ny mobil.

Så förändrar AI dagens robotar – från hemmet till arbetsplatsen

Så förändrar AI dagens robotar – från hemmet till arbetsplatsen

AI gör robotar bättre på att tolka omgivningen och anpassa rörelser. Läs vad som redan fungerar i hem och på jobbet – och vilka begränsningar som finns.