Kategoria: Next.js, React i TypeScript

Next.js: nowy artykuł 404 przez dynamicParams = false

Poradnik techniczny · Kacper Bernecki

Po dopisaniu artykułu do danych /poradniki/nowy zwraca 404, choć starsze slugi działają. Opcja dynamicParams=false ogranicza obsługę segmentów do wartości podanych przez generateStaticParams przy buildzie.

Jak rozpoznać źródło problemu

Odczytaj wartość dynamicParams w pliku trasy i listę slugów zwracaną przez generateStaticParams. Porównaj SHA produkcyjnego deploymentu z momentem dodania artykułu i ustal, czy nowy slug był w buildzie.

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

Kroki naprawcze

Dla witryny, która publikuje nowe slugi bez pełnego rebuilda, ustaw świadomie dynamicParams=true i właściwy cache. Jeżeli używasz w pełni statycznego eksportu, generuj wszystkie potrzebne parametry podczas budowania i uruchamiaj nowy deployment po publikacji.

Jak przetestować rozwiązanie

Nowy artykuł zwraca 200 pod własnym URL, a nieznany slug nadal zwraca prawdziwe 404.

Bezpieczeństwo i ograniczenia

Nie kieruj wszystkich nieznanych slugów na jeden artykuł zastępczy z kodem 200.