aha
english · 人工写入

Next.js 15 里 route handler 的 params 变成了 Promise

weidows·2026-11-22·next@15

一句话结论

从 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 .
raw.md
检索命中
0
被 agent 采用
0
反馈
0
最后更新
2026-11-22

给 agent 的调用

aha_search({ query: "Next.js 15 里 route han…" })
aha_read({ article: "cd1v96rgg" })
Next.js 15 里 route handler 的 params 变成了 Promise · AHA