Next.js動態頁讀不到params:先await再取路徑參數
把舊版動態頁搬到新版Next.js後,原本的 params.slug不能照常使用,型別也提示params像一個Promise。先確認專案版本與這個頁面使用App Router。現行動態路由的params是非同步值,Server Component要先等待它,再從解析出的物件取slug。 這不需要把整頁改成Client Component,也不代表網址裡的slug需要先呼叫某個API。問題在框架提供參數的介面變了。本文用兩條不同網址驗證同一個動態頁,再分清路徑參數、查詢參數與靜態生成,避免看到Promise就改錯資料來源。 動態資料夾的名字決定key 在App Router中,app/items/[slug]/page.js的中括號資料夾代表一個動態區段。請求 /items/alpha 時,slug的值是alpha;請求 /items/bravo 時則是bravo。若資料夾叫 [id],解析物件的key就叫id,不會因為你的變數寫slug就自動更名。 export default async function ItemPage({ params }) { const { slug } = await params return <main><h1>{slug}</h1></main> } Server頁可以是async函式。在函式裡解開params,再把普通字串用於查詢或渲染。這份最小頁只顯示字串,不查資料庫,也不把字串當成可以任意存取的檔案路徑;先核到這層,再接回真正的內容查詢。 容易寫錯的是 await params.slug。它在await之前就先嘗試讀params上的slug;你需要等的是params這個Promise本身。拆成兩行 const resolved = await params與 resolved.slug也可以,只要先後順序清楚。 TypeScript也要標出Promise 如果原頁面的型別仍寫成普通物件,會把舊假設留在編輯器提示裡。新版頁面型別可以把非同步參數直接表達出來。 export default async function ItemPage({ params, }: { params: Promise<{ slug: string }> }) { const { slug } = await params return <main><h1>{slug}</h1></main> } 這個型別對應單一 [slug]區段。catch-all區段是陣列等其他形狀,不能把每一種動態路由都標成string。依資料夾規則選型別,再驗證業務上允許的值;型別描述不等於使用者輸入已符合你的產品規則。 官方文件指出,Next.js14與更早版本的params是同步prop,15保留過同步存取以協助相容,但這種方式會被淘汰。本文真案例使用16.3.8,採現行非同步寫法。維護舊站時先看實際依賴與升級指南,不要對所有版本一律套同一個錯誤訊息。 用兩個slug測,避免只看固定字串 最小測試專案只需基本layout與上述動態頁。啟動後分別請求alpha與bravo,確認兩個回應都正常,而且各自顯示正確值。只測alpha一個網址,可能漏掉程式把測試值硬寫在畫面的錯誤。 curl http://127.0.0.1:3000/items/alpha curl http://127.0.0.1:3000/items/bravo 本文在Next.js16.3.8、React19.3.0的隔離App Router案例中,兩個請求都回200,h1分別是alpha與bravo。這證明params解析與頁面路由對上;它沒有證明任何商品或會員資料已存在,因為範例沒有接業務資料。...
