Kategoria: Next.js, React i TypeScript

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.