Kategoria: Next.js, React i TypeScript

Next.js notFound() kończy jako błąd 500 po złapaniu wyjątku

Poradnik techniczny · Kacper Bernecki

Nieistniejący artykuł powinien zwrócić 404, lecz catch zamienia wewnętrzne notFound() w zwykły błąd aplikacji. Funkcja notFound przerywa renderowanie specjalnym wyjątkiem frameworka, który może zostać niewłaściwie przechwycony.

Jak rozpoznać źródło problemu

Odszukaj wywołania notFound() w blokach try/catch i sprawdź, co robi obsługa catch. W testowym żądaniu porównaj status HTTP nieistniejącego slugu i sposób renderowania not-found.tsx.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

Obsłuż błędy bazy wewnątrz try, a warunek braku rekordu oceniaj poza catch i tam wywołaj notFound(). Zachowaj odrębne stany: brak wpisu, brak uprawnień i awaria API powinny prowadzić do różnych odpowiedzi.

Jak przetestować rozwiązanie

Nieistniejący adres zwraca 404 z właściwą stroną błędu, a awaria bazy nie jest ukryta jako brak wpisu.

Bezpieczeństwo i ograniczenia

Nie zwracaj 200 z samym tekstem „nie znaleziono”, bo to tworzy Soft 404 w SEO.