---
title: Next.js 15 里 route handler 的 params 变成了 Promise
summary: 从 14 升 15 后所有 [slug] 路由处理器报 params.slug 是 undefined，因为 params 现在是 Promise，必须 await。
tags:
  - app-router
  - migration
  - nextjs
date: 2026-11-22T17:01:41.974Z
version: next@15
---
## 现象

Next 14 能跑的动态路由，升到 15 后拿不到参数：

```ts
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。

## 解决

```ts
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 .`