Verificato il 16 settembre 2026. Gli errori di Workbench sono facili da interpretare erroneamente durante un incidente di Salesforce. Un accesso non riuscito può derivare da una sessione scaduta, un ambiente errato, un percorso di Workbench non funzionante o un'interruzione dell'API di Salesforce. Una richiesta che restituisce 503 Service Unavailableun errore punta in una direzione diversa da un errore 401 Invalid Session, anche se entrambi possono verificarsi quando uno sviluppatore sta cercando di lavorare rapidamente.
L'obiettivo della risoluzione dei problemi non è forzare una singola richiesta, bensì identificare quale livello del sistema non funziona, proteggere i dati mentre il sistema è instabile e capire quando le prove sono sufficientemente solide per attendere, cambiare strumento o contattare il canale di supporto appropriato.
| Ciò che vedi | strato più probabile | La mossa migliore da fare ora |
|---|---|---|
| La pagina Workbench non si carica | Sito Workbench, browser, DNS o percorso di rete | Apri Salesforce Trust Status e testa il sito da una rete alternativa autorizzata. |
| Workbench si carica, ma l'accesso fallisce con un errore 401. | Sessione, OAuth, nome utente, password o flusso di accesso | Avvia un nuovo accesso autorizzato e conferma l'ambiente selezionato. |
| La richiesta API restituisce 403 | Autorizzazioni, criteri per le app connesse o limiti API | Verifica i limiti relativi all'utente, all'app connessa e alle richieste; non considerarli una prova di interruzione del servizio. |
| Diverse chiamate API restituiscono 500, 502 o 503 | Piattaforma Salesforce, routing edge, manutenzione o sovraccarico | Confronta il tempo di errore con lo stato della tua istanza e del tuo prodotto su Trust. |
| Solo una query o un oggetto non riesce | Sintassi della richiesta, accesso all'oggetto, condivisione dei record o problema relativo ai dati | Riduci la richiesta a una lettura innocua e sicura e analizza il corpo della risposta. |
Questa tabella è un punto di partenza, non una diagnosi. Lo stesso codice HTTP può avere cause diverse a seconda dell'endpoint, del metodo di autenticazione e delle policy aziendali.
Workbench è una suite basata su browser per interagire con le organizzazioni Salesforce tramite diverse API, tra cui REST, SOAP, Bulk, Streaming, Metadati e strumenti correlati ad Apex. Tuttavia, il sito di Workbench dichiara che non si tratta di un prodotto ufficiale Salesforce e che il supporto Salesforce non è disponibile per Workbench stesso. La pagina "Informazioni" avverte inoltre gli utenti di non utilizzare l'applicazione con dati di produzione.
Questo avviso modifica il modo in cui dovresti comportarti durante i periodi di inattività. Il supporto Salesforce può esaminare un problema relativo a un servizio, un'istanza o un'API di Salesforce, ma potrebbe non essere in grado di risolvere ogni comportamento dell'interfaccia di Workbench. Viceversa, un problema segnalato solo da Workbench potrebbe essere correlato a Workbench stesso o al percorso del browser, anziché alla piattaforma Salesforce.
Se possibile, mantieni le sezioni di risoluzione dei problemi in sola lettura. Non incollare password, segreti OAuth, ID di sessione, token di accesso, dati dei clienti o intestazioni di richiesta non oscurate in screenshot, messaggi di chat o segnalazioni di problemi pubbliche.
Apri Salesforce Trust Status in una scheda separata. La documentazione di supporto di Salesforce indirizza i clienti a questa pagina in caso di interruzioni del prodotto o degrado del servizio, e il sito Trust può mostrare informazioni sia sui prodotti che su casi specifici.
Controlla due visualizzazioni:
Un'istanza contrassegnata come Disponibile non garantisce il funzionamento di tutte le operazioni API. Significa che l'istanza e i relativi servizi sono disponibili in base alla definizione di stato di Salesforce. Degrado delle prestazioni indica che l'accesso potrebbe funzionare con latenza o con funzionalità parziali; Interruzione del servizio indica che l'istanza non è disponibile; Manutenzione indica un evento di manutenzione che potrebbe influire o meno sull'accesso.
Workbench può connettersi a diversi ambienti Salesforce. Prima di concludere che un'API non funziona, è necessario verificare se la richiesta non riuscita è indirizzata all'ambiente di produzione, a un ambiente sandbox o a un altro ambiente autorizzato. Un test che ha successo in un ambiente non esclude che il problema si verifichi nell'ambiente in cui si verifica effettivamente l'errore.
Utilizzate il vostro dominio personale o l'identificativo dell'istanza per l'organizzazione interessata. Salesforce documenta che il prefisso del vostro dominio personale può essere utilizzato in Stato di attendibilità, mentre un amministratore può trovare l'istanza in Configurazione, nella sezione Informazioni sull'azienda . Annotate l'istanza, l'ambiente, la versione dell'API, l'ora approssimativa dell'errore e l'endpoint. Questa semplice informazione evita un errore comune: confrontare un errore di produzione con lo stato corretto di un ambiente di test.
Se la pagina di accesso di Workbench mostra un metodo di accesso non supportato o reindirizza alla schermata di accesso, consideralo un problema di autenticazione o di Workbench separato finché lo stato di attendibilità e un accesso diretto a Salesforce non indichino il contrario. Non inviare ripetutamente le credenziali durante un'interruzione sospetta; tentativi eccessivi possono causare blocchi o complicare l'indagine.
La documentazione dell'API REST di Salesforce spiega che l'intestazione della risposta contiene un codice di stato HTTP e che il corpo di solito contiene un messaggio e, se pertinente, il campo o l'oggetto associato all'errore. Conserva entrambe le prove.
| Codice | Indizio documentato da Salesforce | Come interpretarlo durante i periodi di inattività |
|---|---|---|
| 400 | La richiesta non è stata compresa, spesso perché il corpo JSON o XML non è valido. | Di solito è meglio risolvere la richiesta prima di considerarla un'interruzione del servizio. |
| 401 | L'ID di sessione o il token OAuth è scaduto o non valido. | Riautenticati tramite un flusso approvato; un errore 401 da solo non è prova di un'interruzione della piattaforma. |
| 403 | La richiesta è stata rifiutata, spesso a causa di problemi di autorizzazioni o di limiti dell'API. | Prima di segnalare un problema di disponibilità, verificare l'accesso e i limiti. |
| 500 | Si è verificato un errore nella piattaforma Lightning. | Riprova solo dopo aver registrato la risposta; confronta i ripetuti errori con lo stato di affidabilità. |
| 502 | Salesforce Edge non è riuscito a comunicare correttamente con l'istanza. | È possibile che si tratti di un problema di routing o lato piattaforma, soprattutto in presenza di più richieste. |
| 503 | Il server non è disponibile; potrebbe essere in corso una manutenzione o essere sovraccarico. | Verificare la presenza di incidenti o interventi di manutenzione ed evitare tentativi di ripristino inefficaci. |
Una volta noti lo stato e l'ambiente, utilizzare il test di sola lettura più piccolo consentito. Un buon confronto ha tre caratteristiche: si rivolge all'organizzazione interessata, non modifica i dati ed è sufficientemente semplice da rendere improbabile un errore nel formato della richiesta.
Non utilizzare richieste di scrittura, eliminazione, aggiornamento in blocco, distribuzione di metadati o migrazione come controllo di integrità. Durante un incidente, una scrittura può generare risultati parziali, duplicazione del lavoro o una falsa impressione di ripristino avvenuto.
Smetti di riprogettare la query a meno che tu non abbia prove indipendenti che la richiesta non sia formattata correttamente. Salva il numero dell'incidente, il servizio interessato, l'istanza, l'ora di inizio e l'ultimo aggiornamento. Segui i messaggi di ripristino di Salesforce e proteggi il lavoro in coda da tentativi duplicati.
Concentrati su Workbench, sul browser, sulla rete, sull'autenticazione o sui criteri locali. Prova una finestra di navigazione in incognito, un browser alternativo supportato e un confronto con una rete consentita. Il sito di Workbench indirizza il supporto specifico per Workbench alle risorse della sua community open source, mentre la Guida di Salesforce rimane il canale di supporto per i prodotti e gli account Salesforce.
Passiamo all'analisi di identità e autorizzazione. Verifichiamo l'utente, i criteri dell'app connessa, l'ambito OAuth, la durata della sessione, l'accesso alle API, il profilo o il set di autorizzazioni e i limiti dell'organizzazione. Aggiornare ripetutamente il browser non risolverà un'autorizzazione mancante o un token non valido.
Analizza l'endpoint, l'oggetto, il campo, la condivisione dei record, la versione dell'API, il corpo della richiesta e il corpo della risposta. Un errore circoscritto non è sufficiente per etichettare Salesforce come inutilizzabile a livello globale. Riduci la richiesta fino a quando non riesci a identificare se il problema riguarda la sintassi, l'accesso, i dati o un servizio dipendente.
Se il problema con Salesforce persiste, consulta le linee guida ufficiali del supporto Salesforce disponibili tramite il canale previsto dal tuo Piano di Successo. Includi:
Prima di inviare i log, rimuovi credenziali, ID di sessione, token di accesso, nomi dei clienti, ID dei record e payload sensibili. Se il problema riguarda solo Workbench, utilizza il percorso di supporto indicato nella pagina di aiuto di Workbench ; Salesforce non fornisce supporto per Workbench.
Un indicatore di stato verde è incoraggiante, ma non rappresenta il traguardo finale. Verifica il recupero a più livelli:
Il risultato che desideri non è semplicemente "l'apertura della pagina". Desideri che l'operazione originale autorizzata abbia successo, con la risposta prevista e senza effetti collaterali non verificati.
Per gli errori di Salesforce Workbench durante i periodi di inattività, iniziare con lo stato di attendibilità e l'istanza interessata, quindi classificare la risposta HTTP prima di modificare le credenziali o riscrivere le richieste. Un errore 500, 502 o 503 ripetuto in semplici test di sola lettura e un incidente di attendibilità corrispondente supportano una spiegazione lato Salesforce. Un errore 401, 403, 400 o un errore che si verifica solo in Workbench di solito richiede invece la risoluzione dei problemi di autenticazione, autorizzazioni, richiesta, browser o Workbench. Poiché Workbench non è un prodotto supportato da Salesforce, è necessario non utilizzare dati di produzione, documentare chiaramente i confini e utilizzare le linee guida ufficiali più recenti in materia di stato e supporto quando le prove cambiano.
A practical 2026 guide to AI, smart-home sensors, remote monitoring, fall safety, privacy, and how technology can support aging in place without replacing care.
Scopri come le città possono trasformare i dati relativi a mobilità, uso del suolo, clima e comunità in quartieri più sicuri, più verdi e più vivibili, senza anteporre la tecnologia alle persone.
Confronta i principali programmi di ingegneria aerospaziale e UAV per droni, autonomia, sistemi di controllo, operazioni UAS e ricerca di dottorato, con aggiornamenti verificati fino al 2026.
Una guida pratica alla robotica chirurgica basata sull'intelligenza artificiale: capacità attuali, livelli di autonomia, vantaggi in termini di precisione, limiti, regolamentazione e criteri di valutazione.
Gli investimenti nella cattura e utilizzo del carbonio (CCUS) sono in aumento, ma la cattura del carbonio può davvero invertire le emissioni globali? Scopri dove funziona, quali sono i limiti di scala e quali sono le evidenze scientifiche rilevanti.
Compare seven global programs for digital supply chains, logistics, analytics, global trade, and operations, with practical guidance on choosing the right fit.
Scopri come le interfacce cervello-computer decodificano i segnali neurali per ripristinare la comunicazione e il movimento, quali risultati hanno ottenuto gli studi più recenti e cosa limita ancora l'utilizzo delle BCI.
Scopri come i droni commerciali combinano sensori, intelligenza artificiale edge, batterie, sistemi di comunicazione e software di controllo del volo, e in che modo l'autonomia dipende ancora dalla missione e dalle normative.
Compare seven strong battery and energy storage master's options by materials, systems, research, industry exposure, flexibility, language, and cost trade-offs.
Scopri come la massa del carico utile, i limiti della batteria, le condizioni meteorologiche, l'efficienza della propulsione e l'architettura del velivolo influenzano l'autonomia dei droni industriali e come migliorarla.
