Kategoria: Next.js, React i TypeScript

Next.js output export: dynamic route missing generateStaticParams

Poradnik techniczny · Kacper Bernecki

Projekt z output: export buduje się do momentu przejścia przez trasę dynamiczną i zgłasza brak generateStaticParams. Eksport statyczny nie może na żądanie generować nowych stron, dlatego potrzebuje kompletu adresów znanych podczas builda.

Jak rozpoznać źródło problemu

Sprawdź ustawienie output w next.config i listę tras z segmentami w nawiasach kwadratowych. Ustal, czy dane wszystkich stron istnieją w chwili budowania, czy są pobierane na żądanie.

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

Kroki naprawcze

Dodaj generateStaticParams zwracającą komplet parametrów, gdy zbiór jest znany i skończony. Jeśli adresy mają powstawać dynamicznie, usuń eksport statyczny i użyj hostingu wspierającego renderowanie serwerowe.

Jak przetestować rozwiązanie

Po buildzie istnieje HTML dla każdego przewidzianego slugu, a nowy slug wymaga zamierzonej procedury publikacji.

Bezpieczeństwo i ograniczenia

Nie ustawiaj dynamicParams=true jako rzekomej naprawy ograniczeń statycznego export.