0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Next.js 16 で params を await し忘れると、警告もエラーも出ず空で表示される

0
Last updated at Posted at 2026-11-17

Next.js 16.3.1 で動的ルートの params を await し忘れたときに何が起きるかを、実際に手元で確かめました。書き方によっては、エラーも警告も一切出ないまま画面が空になります。

検証環境は Next.js 16.3.1 / React 19.2.8 / Node.js v22.22.2 です。

対象読者: 動的ルート([slug])を書いていて、v14〜v15 のサンプルをコピーしている方。

結論から

型の書き方 ビルド 実行時
PageProps<'/b/[slug]'>(Next.js が用意する型) ❌ error TS2339 で落ちる —
{ params: { slug: string } }(自分で書いた型) ✅ 通る 🕳️ HTTP 200 で中身が空。警告なし

そして、検索するとよく出てくる params should be awaited というメッセージは、v16.3.1 にはもう存在しません。

「params should be awaited」で検索すると v15 の記事しか出ない理由

node_modules/next/ 全体をこの文字列で検索しました。

grep -rl "params should be awaited" node_modules/next/
# ヒット 0 件

パッケージのどこにもありません。 これは v15 期のメッセージです。v15 では params の同期アクセスが「警告を出しつつ動く」互換モードで残っていましたが、v16 でその互換レイヤーごと消えました。警告を出す対象がなくなったので、メッセージも消えたわけです。

つまり「params should be awaited が出たときの対処法」を書いた記事は、v16 では前提から違います。v16 で起きるのは、この後に書く 2 通りのどちらかです。

パターン 1:Next.js の型を使うと、ビルドで落ちる

v16 では PageProps<'/ルート'> という型がグローバルに用意されています(import は不要です)。

// app/b/[slug]/page.tsx
export default function Page({ params }: PageProps<'/b/[slug]'>) {
  return <p>{params.slug}</p>
}
✓ Compiled successfully in 431ms
  Running TypeScript ...
app/b/[slug]/page.tsx(2,21): error TS2339: Property 'slug' does not exist on type 'Promise<{ slug: string; }>'.
Failed to type check.

Promise<{ slug: string }> には slug なんて生えていない、という TypeScript の素直な指摘です。エラー文に await の話は出てきませんが、Promise と書いてあるので気づけます。

この型の実体は、ビルド時に生成される .next/types/routes.d.ts に入っています。

interface ParamMap {
  "/": {}
  "/b/[slug]": { "slug": string; }
}

declare global {
  interface PageProps<AppRoute extends AppRoutes> {
    params: Promise<ParamMap[AppRoute]>
    searchParams: Promise<Record<string, string | string[] | undefined>>
  }
}

ルートごとのパラメータ名まで生成されています。params が Promise であることが型に埋まっているので、await を忘れたら必ず止まります。これが正しい状態です。

パターン 2:型を自分で書くと、静かに空になる

問題はこちらです。v14 期の記事をコピーすると、こう書くことになります。

// app/b/[slug]/page.tsx
export default function Page({ params }: { params: { slug: string } }) {
  return <p>{params.slug}</p>
}

自分で「params はただのオブジェクトです」と宣言したので、TypeScript は何も言いません。

✓ Compiled successfully in 164ms
  Running TypeScript ...
  Finished TypeScript in 1527ms ...
✓ Generating static pages using 3 workers (2/2) in 137ms

Route (app)
└ ƒ /b/[slug]

ビルドは完全に通ります。 本番モードで起動して /b/hello を叩きました。

--- HTTP ---
200
--- body ---
<p></p>
▲ Next.js 16.3.1
- Local:         http://localhost:3600
✓ Ready in 190ms
✓ Running next.config.ts took 41ms

HTTP 200。中身は空。サーバーのログには何も出ません。

params は実体が Promise なので、params.slug は undefined になります。React は undefined を「何も描かない」として扱うので、空の <p> だけが返ります。エラーではないので、誰も気づきません。

これは、CI でビルドが通り、テストがなければすり抜け、本番で「なぜかタイトルが表示されないページ」として発見される タイプの壊れ方です。

直し方

params を await します。関数を async にする必要があります。

export default async function Page({ params }: PageProps<'/b/[slug]'>) {
  const { slug } = await params
  return <p>{slug}</p>
}

generateMetadata でも同じです。

export async function generateMetadata({ params }: PageProps<'/b/[slug]'>) {
  const { slug } = await params
  return { title: slug }
}

searchParams / cookies() / headers() / draftMode() も同様に Promise です。

予防策:型は自分で書かない

今回の教訓を 1 行にすると、こうなります。

params の型を手で書かないでください。 PageProps<'/ルート'> を使えば、await の忘れは必ずビルドで止まります。手書きの型注釈は、TypeScript に嘘を教えて検出機構を自分で無効化する行為になります。

ネットのサンプルをコピーするときも、{ params: { slug: string } } という形を見たら v15 以前の記事だと判定できます。この形が残っていること自体が、記事の世代の目印になります。

関連

このエラーを含む Next.js 16 のエラー 12 件を、実機で再現した出力そのままで逆引きにまとめた章を無料公開しています。「検索して出てくるのが v15 の記事ばかりで直らない」を潰すために作ったものです。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?