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.