Next.js Route Handler: Body is unusable przy drugim odczycie request.json()
Poradnik techniczny · Kacper Bernecki
Endpoint zwraca błąd Body is unusable albo stream already read, gdy próbuje ponownie odczytać dane POST. Strumień ciała Request można konsumować tylko raz, o ile wcześniej nie wykonano jego klonowania.
Jak ustalić źródło błędu
Sprawdź, czy middleware, logowanie debugowe lub walidacja wykonują request.text() przed request.json().
Zapisz kolejność operacji na obiekcie Request w jednym wywołaniu endpointu.
Co zrobić krok po kroku
1. Odczytaj request.json() dokładnie raz i zachowaj sparsowany obiekt do walidacji i logiki biznesowej.
2. Jeśli konieczny jest podgląd surowej treści, użyj z rozmysłem request.clone() przed konsumpcją i ogranicz rozmiar payloadu.
Jak sprawdzić wynik
Endpoint przyjmuje prawidłowy JSON, a malformed JSON zwraca kontrolowane 400 zamiast wyjątku.
Czego nie robić
Nie zapisuj całej surowej treści żądań z danymi klientów do publicznych logów.