Kategoria: Next.js, React i TypeScript

Next.js: dynamiczna podstrona działa w dev, ale produkcja zwraca 404

Poradnik techniczny · Kacper Bernecki

Lokalnie poradnik lub realizacja otwiera się, ale po publikacji wybrany slug zwraca 404.

Skąd bierze się problem?

Przy statycznym generowaniu część adresów mogła nie trafić do generateStaticParams, a dynamicParams=false blokuje nieznane ścieżki.

Co zrobić krok po kroku?

1. Ustal, czy route używa generateStaticParams i dynamicParams=false.

2. Porównaj żądany slug z listą zwracaną podczas produkcyjnego builda.

3. Sprawdź normalizację wielkości liter, polskich znaków i końcowych ukośników.

4. Upewnij się, że dane poradnika są dostępne podczas kompilacji, a nie dopiero w przeglądarce.

5. Uruchom build i lokalny start produkcyjny, a następnie odwiedź kilka losowych slugów.

Test poprawki i ważna pułapka

Każdy adres ze spisu treści i sitemap zwraca 200 po produkcyjnym buildzie.

Nie ustawiaj dynamicParams=true bez przemyślenia strategii generowania i obsługi błędnych adresów.