Next.js 15: odczyt params.slug bez await generuje błąd
Poradnik techniczny · Kacper Bernecki
Po aktualizacji Next.js dynamiczna trasa zaczyna zgłaszać, że params należy odczytać asynchronicznie. W nowszym App Router params są przekazywane jako wartość typu Promise w odpowiednich funkcjach strony.
Jak ustalić źródło błędu
Sprawdź wersję Next.js i wszystkie miejsca odczytu params w page, layout i generateMetadata.
Porównaj typ Props z rzeczywistym kontraktem funkcji frameworka, zamiast dopisywać rzutowanie any.
Co zrobić krok po kroku
1. Zdefiniuj params: Promise<{slug:string}> i odczytaj const {slug}=await params we właściwej funkcji asynchronicznej.
2. Dla wielu segmentów popraw wszystkie miejsca użycia; przygotuj test otwierający konkretny adres dynamiczny.
Jak sprawdzić wynik
Typecheck i build przechodzą, a wpisanie adresu /poradniki/przyklad otwiera właściwe dane bez ostrzeżeń.
Czego nie robić
Nie kopiuj sygnatur z dokumentacji starszej głównej wersji bez sprawdzenia wersji projektu.