HTTP 422 oznacza, że serwer rozumie format żądania, ale nie może go przetworzyć, bo zawartość jest semantycznie niepoprawna albo nie spełnia reguł walidacji aplikacji. Najczęściej dotyczy to formularza lub API, brakujących pól, złych typów danych, niepoprawnych nagłówków albo błędów po stronie logiki biznesowej.
- HTTP 422 – co to za błąd?
- Kiedy najczęściej pojawia się błąd 422?
- Co oznacza 422 w prostych słowach?
- Najczęstsze przyczyny błędu 422
- Jak naprawić błąd 422? Instrukcja krok po kroku
- Jak naprawić 422 na stronie internetowej jako użytkownik?
- Jak naprawić 422 jako właściciel strony lub administrator?
- Czego nie robić przy błędzie 422
- Najkrótsza definicja do użycia w artykule
HTTP 422 – co to za błąd?
Kod 422 Unprocessable Content (wcześniej 422 Unprocessable Entity) to odpowiedź HTTP informująca, że serwer zrozumiał typ treści i składnię żądania, ale nie jest w stanie wykonać instrukcji zawartych w treści. To odróżnia go od błędu 400 Bad Request, gdzie problem dotyczy już samej składni lub struktury żądania.
W praktyce 422 pojawia się wtedy, gdy:
- formularz ma poprawny format, ale brakuje wymaganego pola,
- pole ma zły typ, na przykład tekst zamiast liczby,
- dane nie spełniają reguł walidacji, na przykład zbyt krótkie hasło, niepoprawny e-mail lub wartość poza zakresem,
- API otrzymuje poprawny JSON, ale niezgodny z oczekiwanym schematem lub logiką aplikacji.
422 a inne kody statusu
Aby szybko odróżnić 422 od pokrewnych błędów, porównaj typowe zastosowania i przykłady:
| Kod | Kiedy używać | Przykład |
|---|---|---|
| 400 Bad Request | składnia lub struktura żądania jest błędna | uszkodzony JSON, brakujący nawias |
| 415 Unsupported Media Type | typ treści nieobsługiwany przez endpoint | Content-Type: text/plain zamiast application/json |
| 409 Conflict | konflikt stanu zasobu | tworzenie obiektu o już istniejącym unikalnym kluczu |
| 422 Unprocessable Content | składnia poprawna, ale dane nie przechodzą walidacji | poprawny JSON z niepoprawnym e-mailem lub zbyt krótkim hasłem |
Kiedy najczęściej pojawia się błąd 422?
Najczęściej kod 422 występuje w trzech sytuacjach:
- podczas wysyłania formularzy na stronie internetowej,
- przy wywołaniach API, zwłaszcza metodami POST, PUT lub PATCH,
- w systemach CMS i panelach administracyjnych, gdy dane przesyłane przez wtyczkę, motyw lub skrypt są niezgodne z wymaganiami serwera.
W środowisku WordPress błąd 422 bywa wiązany z problemami po stronie wtyczek, reguł walidacji i tokenów bezpieczeństwa. Najczęściej pomocne w diagnozie są logi błędów serwera i aplikacji.
Co oznacza 422 w prostych słowach?
Można to ująć tak:
„wiadomość dotarła, ale jej treść jest nie do zaakceptowania”
Serwer wie, co próbujesz zrobić, ale dane nie przechodzą jego kontroli poprawności.
Najczęstsze przyczyny błędu 422
Poniżej zebraliśmy najczęstsze źródła problemu wraz z krótkim objaśnieniem:
- brak wymaganych pól – w formularzu lub żądaniu API brakuje kluczowych parametrów;
- nieprawidłowy format danych – błędny e-mail, data, numer telefonu albo JSON niezgodny ze schematem;
- zły typ danych – na przykład tekst tam, gdzie oczekiwana jest liczba;
- nieprawidłowe nagłówki HTTP – zwłaszcza
Content-Typeniezgodny z przesyłanymi danymi; - błędy walidacji po stronie serwera – zbyt długa nazwa, hasło niespełniające polityki bezpieczeństwa, niedozwolona wartość;
- problemy z tokenami bezpieczeństwa – CSRF, wygasła sesja albo niepoprawny token;
- błędy w integracji API – aplikacja wysyła dane w niewłaściwej strukturze;
- problemy z zapleczem aplikacji – sygnalizowane w logach, wymagające diagnostyki po stronie serwera.
Jak naprawić błąd 422? Instrukcja krok po kroku
1. Sprawdź dane, które wysyłasz
Zweryfikuj kompletność i format wszystkich pól. Jeśli serwer wymaga liczby, nie wysyłaj tekstu; jeśli oczekuje adresu e-mail, upewnij się, że ma prawidłową postać.
W praktyce warto sprawdzić:
- czy wszystkie pola obowiązkowe są wypełnione,
- czy wartości nie są puste,
- czy długość danych mieści się w limicie,
- czy daty, liczby i identyfikatory mają właściwy format.
2. Zweryfikuj Content-Type
Błędny lub brakujący nagłówek Content-Type może spowodować, że serwer nie zinterpretuje poprawnie treści żądania. Dla JSON używaj application/json, a dla formularzy application/x-www-form-urlencoded albo multipart/form-data.
3. Sprawdź dokumentację API
Jeśli problem dotyczy API, porównaj wysyłany payload z dokumentacją endpointu. Zwróć uwagę na:
- nazwy parametrów,
- wymagane pola,
- typy danych,
- strukturę zagnieżdżenia,
- wartości dozwolone i niedozwolone.
4. Przejrzyj komunikat odpowiedzi serwera
Wiele systemów zwraca w odpowiedzi, które pole jest niepoprawne. Taki komunikat często mówi wprost, co trzeba poprawić.
5. Sprawdź tokeny i sesję
Jeżeli formularz lub panel administracyjny używa tokenów CSRF, tokenów sesji albo innych mechanizmów bezpieczeństwa, upewnij się, że są aktualne i dołączane poprawnie. Wygasły token bardzo często powoduje odrzucenie żądania.
6. Przetestuj żądanie w narzędziach deweloperskich
Do diagnostyki przydatne są następujące narzędzia:
- Postman,
- Insomnia,
- cURL,
- zakładka Network w narzędziach deweloperskich przeglądarki.
Dzięki nim możesz porównać kluczowe elementy problematycznego wywołania:
- treść żądania,
- nagłówki,
- odpowiedź serwera,
- dokładny moment wystąpienia błędu.
7. Sprawdź logi serwera lub aplikacji
Jeśli masz dostęp do zaplecza, logi często pokazują konkretną regułę walidacji, która została naruszona. W środowiskach WordPress pomocny bywa plik debug.log, jeśli debugowanie jest włączone.
8. Popraw walidację po stronie serwera
Jeśli błąd wynika nie z danych użytkownika, lecz z logiki aplikacji, skoryguj reguły walidacji i komunikaty błędów. Serwer powinien akceptować poprawne dane i odrzucać tylko te, które rzeczywiście są niezgodne z zasadami aplikacji.
Jak naprawić 422 na stronie internetowej jako użytkownik?
Jeśli jesteś zwykłym użytkownikiem strony, zastosuj te proste kroki:
- odśwież stronę i spróbuj ponownie,
- uzupełnij wszystkie pola formularza,
- sprawdź poprawność e-maila, numeru telefonu i dat,
- wyczyść pamięć podręczną przeglądarki i ciasteczka, jeśli problem powtarza się długo,
- spróbuj innej przeglądarki lub urządzenia,
- jeśli błąd dotyczy formularza kontaktowego, zgłoś problem administratorowi strony.
Jak naprawić 422 jako właściciel strony lub administrator?
Jeśli zarządzasz stroną, sprawdź kolejno:
- logi aplikacji i serwera,
- konfigurację formularza lub endpointu API,
- poprawność nagłówków HTTP,
- działanie walidacji po stronie backendu,
- wtyczki, motywy i ostatnie zmiany w kodzie,
- aktualność systemu, bibliotek i integracji.
W przypadku WordPressa może pomóc każda z poniższych czynności:
- włączenie trybu debugowania,
- sprawdzenie
debug.log, - przetestowanie formularza po wyłączeniu ostatnio dodanych wtyczek,
- weryfikacja poprawności danych przesyłanych przez motyw lub plugin.
Czego nie robić przy błędzie 422
Dla oszczędzenia czasu i uniknięcia dodatkowych błędów, nie rób tego:
- nie zakładaj automatycznie, że problem leży w przeglądarce — bardzo często winne są dane lub walidacja po stronie aplikacji,
- nie ignoruj komunikatów o konkretnych polach, bo zwykle wskazują źródło problemu,
- nie poprawiaj tylko frontendu, jeśli backend nadal odrzuca dane,
- nie zmieniaj losowo nagłówków bez sprawdzenia dokumentacji API.
Najkrótsza definicja do użycia w artykule
HTTP 422 to błąd oznaczający, że serwer zrozumiał żądanie, ale nie może go przetworzyć, ponieważ zawiera ono błędy semantyczne lub nie spełnia reguł walidacji.
