HTTP 415 Unsupported Media Type przy wysyłaniu formularza
Poradnik techniczny · Kacper Bernecki
Serwer odrzuca poprawne dane formularza statusem 415 zanim przejdzie do walidacji treści. Endpoint oczekuje innego Content-Type niż deklarowany przez klienta, np. JSON vs multipart/form-data.
Jak ustalić źródło błędu
Sprawdź nagłówek Content-Type oraz faktyczny format payloadu w Network.
Porównaj typ deklarowany przez API z parserem użytym po stronie serwera.
Co zrobić krok po kroku
1. Dla JSON ustaw application/json i wyślij rzeczywisty JSON.stringify obiektu. Rozdziel przesyłanie zwykłych pól od plików; większość bibliotek inaczej serializuje FormData niż obiekty JSON.
2. Dla FormData nie ustawiaj ręcznie boundary; pozwól przeglądarce utworzyć poprawny nagłówek multipart.
Jak sprawdzić wynik
Serwer prawidłowo parsuje oba przewidziane formaty albo jasno odrzuca nieobsługiwany typ.
Czego nie robić
Nie ustawiaj Content-Type: application/json dla surowego obiektu FormData.