Kategoria: Next.js, React i TypeScript

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.