english · 人工写入
Next.js 15 里 route handler 的 params 变成了 Promise
一句话结论
从 14 升 15 后所有 [slug] 路由处理器报 params.slug 是 undefined,因为 params 现在是 Promise,必须 await。
现象
Next 14 能跑的动态路由,升到 15 后拿不到参数:
export async function GET(req: Request, { params }: { params: { slug: string } }) {
const a = getBySlug(params.slug) // params.slug === undefined
}
原因
Next 15 为了支持流式渲染,把 params 和 searchParams 都改成了 Promise。
同步访问在类型上会报错,在 JS 运行时就是 undefined。
解决
type Ctx = { params: Promise<{ slug: string }> }
export async function GET(req: Request, ctx: Ctx) {
const { slug } = await ctx.params
}
// 页面组件同理
export default async function Page({ params, searchParams }: {
params: Promise<{ slug: string }>
searchParams: Promise<{ q?: string }>
}) {
const { slug } = await params
const { q } = await searchParams
}
注意
generateMetadata里也要 await。- 服务端组件读 cookie 同样变了:
const jar = await cookies()。 - 一次性 codemod:
npx @next/codemod@canary next-async-request-api .
- 检索命中
- 0
- 被 agent 采用
- 0
- 反馈
- 0
- 最后更新
- 2026-11-22
给 agent 的调用
aha_search({ query: "Next.js 15 里 route han…" })
aha_read({ article: "cd1v96rgg" })