Ja Salesforce Workbench pēkšņi pārstāj pieteikties, REST Explorer atgriež kļūdu vai vaicājumam, kas darbojās pirms vairākām minūtēm, sākas taimauts, ātrākais veids ir neklikšķināt uz “Mēģināt vēlreiz”. Vispirms nosakiet, kurš slānis rada kļūmi: Workbench tīmekļa lietotne, jūsu pārlūkprogramma vai tīkls, Salesforce autentifikācija, jūsu konkrētā Salesforce instance vai pats API pieprasījums.
Šī atšķirība ir svarīga, jo Workbench ir kopienas uzturēta, tīmekļa API utilīta, nevis pilnībā atbalstīts Salesforce produkts. Salesforce nepārprotami norāda, ka tas neuztur Workbench un iesaka atbalstītas alternatīvas, piemēram, Salesforce CLI, Code Builder un Salesforce Extensions for Visual Studio Code. Arī pats Workbench projekts apraksta rīku kā paredzētu tikai apkopei. Skatiet Salesforce Workbench aizstāšanas norādījumus un sākotnējo Workbench avota repozitoriju .
Izmantojiet šo lapu kā praktisku atsauci, ja rodas aizdomas par pakalpojuma darbības pārtraukumu vai pasliktināšanos. Mērķis ir saglabāt pierādījumus, izvairīties no nevajadzīgiem atkārtotiem mēģinājumiem un izlemt, vai gaidīt, mainīt rīkus vai labot kaut ko lokāli.
| Pārbaudiet | Ko meklēt | Ko tas jums stāsta |
|---|---|---|
| Salesforce uzticības | Incidenta, degradācijas, uzturēšanas vai konkrētam gadījumam raksturīga ietekme | Vai Salesforce ziņo par platformas puses problēmu |
| Pats darbagalds | Vai pieteikšanās lapa var ielādēties? Vai OAuth pāradresācija notiek pareizi? | Vai kopienas mitinātais rīks ir sasniedzams |
| Salesforce pieteikšanās | Vai varat ierastajā veidā pieteikties organizācijā? | Vai autentifikācija ir plaši ietekmēta |
| Minimāls API izsaukums | Izmēģiniet vieglu galapunktu, piemēram, /services/data/vai/services/data/v66.0/limits | Vai API ceļš darbojas neatkarīgi no sarežģīta vaicājuma |
| Kļūdas kods | 401, 403, 404, 5xx, taimauts, REQUEST_LIMIT_EXCEEDED,UNSUPPORTED_API_VERSION | Kuru problēmu novēršanas nodaļu ievērot |
| Otrais klients | Salesforce CLI, esoša integrācija vai cits apstiprināts API klients | Vai kļūme ir raksturīga tikai Workbench? |
Dodieties uz oficiālo Salesforce uzticamības statusa vietni un meklējiet instanci, domēnu, podu vai nomnieku, kas attiecas uz jūsu organizāciju. Salesforce incidenti var būt reģionāli vai specifiski konkrētai instancei, tāpēc zaļš statuss nesaistītai instancei nepierāda, ka jūsu organizācija ir labā stāvoklī.
Ja Trust ziņo par pakalpojuma pārtraukumu, veiktspējas pasliktināšanos, pieteikšanās problēmu vai apkopi, kas ietekmē jūsu vidi, reģistrējiet incidenta ID un laiku. Pēc tam izvairieties no spekulatīvu izmaiņu veikšanas pievienotajās lietotnēs, akreditācijas datos, profilos, atļauju kopās, tīkla politikās vai API versijās, ja vien kļūda īpaši nenorāda uz šiem iestatījumiem. Konfigurācijas izmaiņas, kas veiktas pārtraukuma laikā, var radīt otru problēmu pēc platformas atjaunošanas.
Workbench bieži nodod Salesforce API kļūdu atbildes cauri ar nelielu interpretāciju. Tas ir noderīgi problēmu risināšanā: precīzs HTTP statuss, Salesforce kļūdas kods, galapunkts un ziņojums parasti sniedz vairāk informācijas nekā vispārīgs pārlūkprogrammas baneris.
Taimauts, 502, 503 vai cita 5xx atbilde var liecināt par pakalpojuma degradāciju, pārslogotu infrastruktūru vai starpposma tīkla kļūmi. Nepieņemiet, ka 5xx pierāda Salesforce mēroga darbības pārtraukumu. Salīdziniet to pašu vieglo pieprasījumu no cita apstiprināta klienta un pārbaudiet uzticamību. Ja vairāki klienti vienlaikus neizdodas vienā un tajā pašā Salesforce instancē, pierādījumi norāda uz pretējo tikai Workbench.
Parasti tas norāda uz autentifikācijas vai sesijas problēmām. Atkārtoti autentificējieties ar OAuth, nevis kopējiet vecos sesijas ID starp pārlūkprogrammām. Ja arī parastā Salesforce pieteikšanās neizdodas un Trust ziņo par pieteikšanās ietekmi, pirms akreditācijas datu maiņas pagaidiet pakalpojuma atjaunošanos. Ja Salesforce pieteikšanās darbojas, bet Workbench OAuth nedarbojas, izpētiet Workbench pievienotās lietotnes ceļu vai izmantojiet atbalstītu alternatīvu klientu.
403 parasti nozīmē, ka pieprasījums sasniedza pakalpojumu, kas to noraidīja. Pārbaudiet lietotāja atļaujas, pievienotās lietotnes politiku, IP ierobežojumus un precīzu Salesforce kļūdas kodu. Viens zināms Workbench specifisks piemērs ir OAUTH_APP_BLOCKED, kas var rasties, ja administrators bloķē Workbench pievienoto lietotni. Workbench projekta pievienotās lietotnes vadlīnijās ir aprakstīts šis scenārijs.
Aizdomīgas darbības pārtraukuma laikā neveiciet diagnostiku, izmantojot masveida ielādi, metadatu izvietošanu, garu SOQL vaicājumu vai vairāku soļu skriptu. Sāciet ar tikai lasāmu galapunktu, kuru ir lēti izpildīt. REST Explorer pieprasījums, piemēram, GET /services/data/pārbauda API pamata sasniedzamību. Pieprasījums, piemēram, GET /services/data/v66.0/limitsvar palīdzēt pārbaudīt organizācijas ierobežojumus, kad API darbojas.
Salesforce dokumentē Workbench REST Explorer kā veidu, kā izsaukt REST galapunktus, taču Workbench nav ideāli piemērots lielām vai veiktspējas ziņā ietilpīgām darbībām. Sākotnējā Workbench dokumentācijā ir norādīts, ka pārlūkprogrammas un savienojuma taimautu dēļ tas ir labāk piemērots ātrai, tūlītējai API mijiedarbībai, nevis lieliem datu ielādes vai eksportēšanas procesiem.
REQUEST_LIMIT_EXCEEDEDTas nav tas pats, kas platformas darbības pārtraukums. Salesforce piemēro API pieprasījumu piešķiršanu, un, ja organizācija pārsniedz savu mainīgo lietošanas ierobežojumu, turpmāki API izsaukumi var tikt bloķēti, līdz lietojums nokrītas zem sliekšņa. Salesforce 2026. gada jūlija atbalsta rakstā ir apstiprināts, ka REST API, SOAP API, Bulk API un Bulk API 2.0 izsaukumi visi veicina API patēriņu. Skatiet Salesforce norādījumus par REQUEST_LIMIT_EXCEEDED un tā mainīgā API ierobežojuma skaidrojumu .
Ja kļūda ir ierobežojuma nosacījums, atkārtoti mēģinājumi situāciju pasliktina, patērējot vairāk izsaukumu, kad pieprasījumi joprojām tiek pieņemti. Identificējiet liela apjoma integrācijas, apturiet nebūtiskus uzdevumus, ja tas ir operacionāli droši, un uzraugiet lietojumu Salesforce iestatījumos. Negaidiet, līdz uzticēšanās incidents atrisinās nomniekam raksturīgu ierobežojuma problēmu.
UNSUPPORTED_API_VERSIONir pelnījis savu atzaru. Salesforce 2026. gada maijā publicēja atbalsta rakstu, kurā paskaidrots, ka Workbench var pēc noklusējuma izmantot jaunāku API versiju, pirms ražošanas vai izstrādātāja versijas organizācija to atbalsta. Ieteicamais Workbench labojums ir pazemināt noklusējuma API versiju līdz tādai, ko atbalsta mērķa organizācija. Skatiet Salesforce problēmu novēršanas rakstu UNSUPPORTED_API_VERSION .
Tas ir svarīgi izlaišanas periodos, jo API versijas neatbilstība var izskatīties pēc darbības pārtraukuma, ja koncentrējaties tikai uz laiku. Pirms gaidāt platformas atkopšanu, pārbaudiet pašu versijas kļūdu.
Ja uzdevums ir steidzams un Workbench ir vienīgā komponente, kas neizdodas, reproducējiet mazāko pieprasījumu, izmantojot Salesforce CLI vai citu atbalstītu, apstiprinātu klientu. Mērķis ir diagnostika, nevis īstas Salesforce darbības pārtraukuma apiešana. Ja abi klienti neizdodas vienā un tajā pašā organizācijā ar salīdzināmām servera puses kļūdām, rīku maiņa, visticamāk, neatjaunos pakalpojumu. Ja CLI izdodas, bet Workbench neizdodas, jums ir spēcīgāki pierādījumi, ka problēma ir Workbench mitināšanā, pārlūkprogrammas sesijā vai pievienotās lietotnes ceļā.
Apstiprināta pakalpojuma pārtraukuma laikā agresīvi manuāli atkārtoti mēģinājumi reti palīdz. Automatizētiem klientiem izmantojiet ierobežotus atkārtotus mēģinājumus ar eksponenciālu atlikšanu un svārstībām, ja to atļauj jūsu integrācijas dizains. Manuālas Workbench lietošanas gadījumā pirms tā paša pieprasījuma atkārtošanas nogaidiet jēgpilnu statusa atjauninājumu vai saprātīgu intervālu.
Rakstīšanas operāciju gadījumā esiet īpaši uzmanīgi. Taimauts ne vienmēr pierāda, ka Salesforce neko nav darījis; klients, iespējams, ir zaudējis atbildi pēc tam, kad serveris ir apstrādājis pieprasījumu. Pirms atkārtotas izveides, atjaunināšanas, dzēšanas vai izvietošanas darbības iesniegšanas pārbaudiet, vai sākotnējā darbība ir veikta. Dublikātu rakstīšana bieži vien ir kaitīgāka nekā aizkavēta atkārtota mēģinājuma veikšana.
| Simptoms | Visnoderīgākā nākamā pārbaude | Izvairieties |
|---|---|---|
| Darbagalda lapa netiek ielādēta | Pārbaudiet Workbench sasniedzamību un izmantojiet citu apstiprinātu klientu. | Salesforce atļauju tūlītēja maiņa |
| OAuth pāradresācijas neizdodas | Pārbaudiet Salesforce pieteikšanās, uzticamības un pievienoto lietotņu politiku | Sesijas ID vai akreditācijas datu koplietošana |
| REST Explorer atgriež 5xx | Pārbaudiet uzticamību un atkārtojiet minimālu tikai lasīšanas zvanu no otra klienta | Lielāku testa darbu veikšana |
REQUEST_LIMIT_EXCEEDED | Pārskatīt organizācijas API patēriņu un mainīgos ierobežojumus | Ātri atkārtoti mēģinājumi |
UNSUPPORTED_API_VERSION | Atlasiet API versiju, ko atbalsta mērķa organizācija. | Gaidot elektroenerģijas padeves pārtraukumu, kura, iespējams, nemaz nav |
| Tikai viens sarežģīts vaicājums beidz darboties ar taimautu | Vienkāršojiet vaicājumu un pārbaudiet selektivitāti/apjomu | Pieņemot, ka dīkstāve ir visā platformā |
errorCodeun īss atbildes fragments.Nekad neielīmējiet piekļuves žetonus, paroles, sesijas ID, OAuth autorizācijas kodus vai pilnus sensitīvus vērtumus koplietotajās biļetēs vai tērzēšanas kanālos.
Pārslēdzieties no Workbench, ja kļūme ir nepārprotami izolēta un tiek izmantota tikai Workbench, ja darbība ir pārāk liela pārlūkprogrammā balstītai utilītai, ja nepieciešama atkārtojama skriptēta darbība vai ja nepieciešama atbalstīta izstrādes darbplūsma. Salesforce aizstāšanas vadlīnijas īpaši norāda izstrādātājiem uz Code Builder, Salesforce CLI un Salesforce paplašinājumiem VS Code.
Nepārslēdziet rīkus tikai tāpēc, lai turpinātu traucēt nepieejamu Salesforce pakalpojumu. Cits klients nevar novērst servera puses darbības pārtraukumu, un atkārtoti zvani var padarīt diagnozi trokšņaināku. Dīkstāves laikā labākais rezultāts ir skaidra klasifikācija: apstiprināts platformas incidents, tikai Workbench kļūme, lokālā tīkla/pārlūkprogrammas problēma, API versijas neatbilstība, atļauju/autentifikācijas problēma, API ierobežojuma izsīkums vai ar pieprasījumu saistīta kļūme.
Salesforce Workbench kļūdas ir vieglāk apstrādāt, ja tās uztverat kā signālus, nevis diagnozes. Pārbaudiet Salesforce Trust, saglabājiet precīzu kļūdu, samaziniet pieprasījumu, salīdziniet ar vienu atbalstītu klientu un sekojiet kļūdas kodam. Šī secība palīdz izvairīties no nevajadzīgām konfigurācijas izmaiņām pārtraukumu laikā, vienlaikus atklājot problēmas, kas izskatās pēc dīkstāves, bet patiesībā ir specifiskas konkrētam nomniekam vai Workbench.
Pārskatiet ievērojamākos Salesforce darbības pārtraukumus 2025. gadā, kas neizdevās, cik ilgi ilga atlasītie incidenti un praktiskās noturības mācības, ko komandas var pielietot.
Izveidojiet praktisku Salesforce dīkstāves nepārtrauktības plānu ar ietekmes analīzi, RTO/RPO mērķiem, manuāliem risinājumiem, integrācijas vadīklām un atkopšanas pārbaudēm.
Uzziniet, kā sazināties ar Salesforce atbalsta dienestu nopietnas elektroenerģijas padeves pārtraukuma laikā: pārbaudiet uzticamības statusu, izvēlieties pareizo kanālu, atveriet spēcīgu pieteikumu un izsekojiet atkopšanas gaitu.
Novērsiet Salesforce Workbench pieteikšanās, REST Explorer, taimauta, 503, API versijas problēmas un ierobežojiet kļūdas dīkstāves laikā, izmantojot praktisku diagnostikas kontrolsarakstu.
StoreForce problēmas var traucēt darba grafiku, laika uzskaiti un darbinieku darbplūsmas. Uzziniet, kā novērtēt ietekmi, nodrošināt veikalu darbību, pārbaudīt problēmu risināšanu un zināt, kad tās ir jārisina.
Izprotiet galvenos plaši izplatīto mākoņpakalpojumu dīkstāves cēloņus, to, kā kļūmes kaskādes veidā izplatās, kas jāpārbauda vispirms un kā izstrādāt noturīgāku atkopšanas plānu.
Ja šķiet, ka Datorama vai Marketing Cloud Intelligence nedarbojas, izmantojiet šo uz pierādījumiem balstīto kontrolsarakstu, lai pārbaudītu darbības traucējumu, aizsargātu pārskatu kvalitāti un zinātu, kad dati atkal ir uzticami.
Praktisks ieskats tajā, kā Heroku darbības pārtraukumi var ietekmēt izvietotās lietotnes, dinamometrus, maršrutēšanu, datubāzes, izvietošanu, Heroku Connect, žurnālus un atkopšanu.
Izprotiet, kā Salesforce un AWS savienojas, izmantojot Hyperforce, integrācijas, tīklošanu, datu glabāšanu, elektroenerģijas padeves pārtraukumus un kopīgu operatīvo atbildību.
AWS darbības pārtraukums ne vienmēr nozīmē, ka Salesforce nedarbojas. Uzziniet, kā Hyperforce, reģioni, instances un Salesforce Trust nosaka, vai jūsu organizācija ir ietekmēta.
