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 | Livello più probabile | La mossa migliore da fare |
|---|---|---|
| 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 nello 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 evitare di 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.
Confronta Collabora Online e ONLYOFFICE Docs sullo stesso server con un test ripetibile per l'utilizzo della memoria, il tempo di apertura del documento e il ritardo nella modifica collaborativa.
Confronta il comportamento di documenti, fogli di calcolo e layout in ONLYOFFICE Docs e nelle app web di Microsoft 365, quindi esegui un test rapido per scegliere l'editor più sicuro per i tuoi file.
Individua le discrepanze nelle formule, che possono riguardare la sintassi, i separatori regionali, i ricalcoli, i sistemi di data o le funzioni non supportate, quindi verifica la cartella di lavoro prima di condividerla.
Scopri cosa possono (e non possono) dimostrare i dati delle versioni più recenti, quindi confronta entrambe le suite per ufficio utilizzando gli stessi file e lo stesso computer.
Confronta le corrispondenze esatte, le ricerche a sinistra, la gestione dei valori mancanti e il supporto delle versioni per poter scegliere una formula Calc affidabile.
Scopri come gli stili di pagina di Writer e i collegamenti tra le sezioni di Word influiscono sulle pagine di copertina, sui numeri romani e sulla ripresa della numerazione quando sposti un documento.
Confronta Pardus Software Center con i comandi APT per trovare, installare, rimuovere e aggiornare i pacchetti utilizzando il metodo più adatto alle tue esigenze.
Scopri cosa significano i requisiti di RAM pubblicati da Pardus, quindi confronta XFCE e GNOME sullo stesso PC con letture ripetibili di MemAvailable.
Scopri come HamoniKR 8.0 si inserisce in un piano di desktop aziendale, quali funzionalità specifiche per la lingua coreana supporta e cosa verificare prima di un'implementazione su larga scala.
Scopri come funzionano insieme la verifica all'avvio e le protezioni in fase di esecuzione di Gooroom, cosa significa "sandbox" e quali impostazioni dovresti verificare sul tuo dispositivo.
