Odczytywanie błędów w transmisji
Interpretuj kody i komunikaty błędów, gdy wywołania kończą się niepowodzeniem.
Odczytywanie błędów w transmisji to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej MCP Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs MCP Academy zawiera 4 lekcji w sumie.
Gdy wywołania kończą się niepowodzeniem
Nie każde żądanie kończy się powodzeniem. Gdy coś pójdzie nie tak, JSON-RPC odsyła obiekt error zamiast wyniku, a jego odczytanie to najszybsza droga do rozwiązania problemu.
Obiekt error
Odpowiedź z błędem zachowuje id żądania, ale zamiast pola result zawiera obiekt error z kodem i komunikatem.
{"jsonrpc": "2.0", "id": 3,
"error": {"code": -32601, "message": "Method not found"}}Kody są liczbami
Każdy błąd zawiera liczbowy code. Standardowe kody JSON-RPC to liczby ujemne, a kilka z nich pojawia się w komunikacji wyjątkowo często.
Błąd parsowania: -32700
Kod -32700 oznacza, że serwer nie mógł nawet sparsować kodu JSON. Zwykle przyczyną jest zbędny przecinek albo niepoprawny cudzysłów, który uszkodził całą wiadomość.
{"error": {"code": -32700, "message": "Parse error"}}Nie znaleziono metody: -32601
Kod -32601 oznacza, że metoda o podanej nazwie nie istnieje. Sprawdź literówkę albo to, czy metoda nie została nigdy udostępniona przez serwer, na przykład toolz/list.
{"error": {"code": -32601, "message": "Method not found"}}Nieprawidłowe parametry: -32602
Kod -32602 wskazuje niepoprawne parametry: brakujący argument albo niewłaściwy typ. Metoda istnieje, ale przesłane dane do niej nie pasują.
{"error": {"code": -32602, "message": "Invalid params"}}Błąd wewnętrzny: -32603
Kod -32603 to ogólny kod wewnętrznego błędu serwera. Żądanie było poprawne, ale podczas jego obsługi wystąpił problem.
{"error": {"code": -32603, "message": "Internal error"}}Odczytaj pole message
Kod wskazuje kategorię błędu, a message opisuje jego przyczynę. Zawsze go odczytuj, ponieważ serwery często podają dokładne pole lub powód, który spowodował błąd.
Opcjonalne dane szczegółowe
Błędy mogą również zawierać pole data z dodatkowymi uporządkowanymi informacjami, na przykład informacją o odrzuconym parametrze. Jeśli jest dostępne, bardzo pomaga w debugowaniu.
{"error": {"code": -32602, "data": {"field": "a"}}}Błąd protokołu a błąd narzędzia
Błąd error JSON-RPC oznacza awarię samego protokołu. Narzędzie, które działa, ale zwraca isError, nadal zwraca zwykły wynik — nie należy mylić tych dwóch sytuacji.
Nawyk debugowania
Wypracuj następujący nawyk: odczytaj code, aby sklasyfikować błąd, odczytaj message, aby zawęzić jego źródło, a następnie sprawdź data, by znaleźć dokładną przyczynę. W ten sposób większość błędów MCP szybko daje się rozwiązać.
Szybkie sprawdzenie
Wysłano poprawną metodę, ale zabrakło argumentu. Który kod błędu pasuje?
Podsumowanie: odczytywanie błędów
Potrafisz już sprawnie odczytywać błędy: obiekt error zawiera code, message, a czasem także data. Code klasyfikuje błąd, message go wyjaśnia, a data wskazuje dokładną przyczynę.
Często zadawane pytania
Czy lekcja „Odczytywanie błędów w transmisji” jest bezpłatna?
Tak — pełny tekst „Odczytywanie błędów w transmisji” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu MCP Academy, przejdź na CoddyKit PRO. Kurs MCP Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Odczytywanie błędów w transmisji”?
Interpretuj kody i komunikaty błędów, gdy wywołania kończą się niepowodzeniem. Ćwiczysz MCP Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć MCP Academy?
Nie wymagamy żadnego doświadczenia. MCP Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Odczytywanie błędów w transmisji”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji MCP Academy?
Tak. Każda lekcja MCP Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Żądania, odpowiedzi i powiadomienia
- Budowa wywołania JSON-RPC
- Uzgadnianie inicjalizacyjne
- Odczytywanie błędów w transmisji