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.