Leggere gli errori sul wire
Decodifichi i codici e i messaggi di errore quando le chiamate falliscono.
Leggere gli errori sul wire è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.
Quando le chiamate vanno storte
Non tutte le richieste vanno a buon fine. Quando si verifica un errore, JSON-RPC restituisce un oggetto error invece di un risultato; leggerlo è il modo più rapido per risolvere il problema.
L'oggetto error
Una risposta di errore mantiene l'id della richiesta, ma sostituisce result con un oggetto error che contiene un codice e un messaggio.
{"jsonrpc": "2.0", "id": 3,
"error": {"code": -32601, "message": "Method not found"}}I codici sono numeri
Ogni errore contiene un code numerico. I codici standard di JSON-RPC sono numeri negativi e alcuni ricorrono continuamente durante la comunicazione.
Errore di analisi: -32700
Il codice -32700 significa che il server non è riuscito nemmeno ad analizzare il JSON. Di solito il messaggio contiene una virgola fuori posto o una virgoletta non corretta.
{"error": {"code": -32700, "message": "Parse error"}}Metodo non trovato: -32601
Il codice -32601 indica che il nome del metodo non esiste. Verifichi la presenza di un refuso o di un metodo mai pubblicizzato dal server, come toolz/list.
{"error": {"code": -32601, "message": "Method not found"}}Parametri non validi: -32602
Il codice -32602 segnala parametri errati: manca un argomento oppure il tipo è sbagliato. Il metodo esiste, ma gli input inviati non sono compatibili.
{"error": {"code": -32602, "message": "Invalid params"}}Errore interno: -32603
Il codice -32603 è l'errore interno generico del server. La richiesta era corretta, ma si è verificato un problema durante la sua gestione.
{"error": {"code": -32603, "message": "Internal error"}}Legga il campo message
Il codice indica la categoria; il campo message racconta che cosa è successo. Lo legga sempre, perché spesso i server aggiungono il campo preciso o il motivo dell'errore.
Dati facoltativi per i dettagli
Gli errori possono contenere anche un campo data con ulteriori dettagli strutturati, ad esempio quale parametro è stato rifiutato. Quando presente, è molto utile per il debugging.
{"error": {"code": -32602, "data": {"field": "a"}}}Errore di protocollo o errore dello strumento
Un error JSON-RPC significa che si è verificato un problema nel protocollo stesso. Uno strumento che viene eseguito ma restituisce isError rimane un risultato normale: non confonda i due casi.
Un riflesso per il debugging
Prenda questa abitudine: legga il code per classificare l'errore, il message per localizzarlo, quindi controlli data per individuare la causa esatta. In questo modo la maggior parte dei bug MCP si risolve rapidamente.
Verifica rapida
Ha inviato un metodo valido, ma manca un argomento. Quale codice di errore è appropriato?
Riepilogo: decodificare gli errori
Ora sa leggere gli errori con facilità: un oggetto error contiene un codice, un messaggio e talvolta i dati. Il codice classifica, il messaggio spiega e i dati individuano la causa.
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Leggere gli errori sul wire» è gratuita?
Sì — il testo completo di «Leggere gli errori sul wire» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.
Cosa imparerò in «Leggere gli errori sul wire»?
Decodifichi i codici e i messaggi di errore quando le chiamate falliscono. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare MCP Academy?
Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.
Quanto tempo richiede la lezione «Leggere gli errori sul wire»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione MCP Academy?
Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Richieste, risposte e notifiche
- Anatomia di una chiamata JSON-RPC
- L'handshake di inizializzazione
- Leggere gli errori sul wire