Next.js 16徹底解説 React 19.2時代のフルスタック開発完全ガイド

約40分で読めます by ぽんたぬき
Next.js 16徹底解説 React 19.2時代のフルスタック開発完全ガイド

Next.js 16徹底解説 React 19.2時代のフルスタック開発完全ガイド


1. はじめに:Next.js 16が変えるフルスタック開発の常識

キミ!!Next.js 16、もう触ってみましたか?😆 「また大型アップデートか〜」くらいに思って変更点リストを開いたら——根本から変わってるんデスヨ……✨ Turbopack がデフォルトになって、キャッシュの考え方がガラッと変わって、しかも middleware.tsproxy.ts に変わって……一気にこれだけ変えてくるとは!!😭

でもサ、全部わかった時の爽快感はもう格別デスヨ🎉 ということで今日は、Next.js 16 × React 19.2 の全貌を、実際にハマったポイント込みで全部解説しちゃいますヨ♪

1-1. この記事の対象読者と前提知識

こんなキミに読んでほしいんデスヨ!!✨

  • Next.js 14〜15 を業務や副業で使っている方
  • 「Next.js 16って何が変わったの?」を5分でまとめられない状態の方
  • use cache とか proxy.ts という単語を見て「???」となった方
  • React Compiler が「なんか自動で最適化してくれる便利なやつ」くらいの理解止まりの方

前提知識は TypeScript がなんとなく読める・書けるレベルでOKデス!!細かい文法は都度補足しますネ🎵

1-2. Next.js 15 から16へ:何がそんなに違うのか

一言で言うと——「暗黙依存だった部分を全部、明示的に書かせる方向に舵を切った」って感じなんデスヨ💡 キャッシュも、ネットワーク境界も、レンダリングの単位も、全部「意図をコードに書いてください」とフレームワーク側が言いはじめた感じデス。最初は少し手間に感じるんですケド、慣れたらバグが激減するんデスヨネ🎵

1-3. 記事の読み方・ハンズオン環境の準備

最新の Next.js 16 を試すには、まずこのコマンドで新規プロジェクトを作りましょう!!

# Node.js 未インストールの場合はまずインストール(Ubuntu/Debian 例)
# curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# sudo apt-get install -y nodejs

npm exec -- create-next-app@latest my-next16-app
# Node.js 20.9以上が必須!確認は node -v で

Node.js のバージョン確認、忘れがちなんデスヨネ😅 Node.js 18 のまま突っ込んでエラー祭りになった経験のある方、けっこういるんじゃないデスカ。キミはちゃんと node -v してから進めてネ♪


2. Next.js 16 / React 19.2 のリリース概要

2-1. Next.js 16(2025年10月)リリースハイライト

2025年10月21日、ついにリリースされましたヨ、Next.js 16!!🎉 主要な変更点を先にドーンと出しちゃいますネ✨

変更点 内容
Turbopack デフォルト化 Webpack を置き換え、デフォルトバンドラーに昇格
"use cache" ディレクティブ キャッシュを明示的オプトイン方式に刷新
proxy.ts middleware.ts が非推奨、Node.js ランタイムで動作する新ファイルへ
React Compiler 安定版 自動メモ化が本番利用可能に
Cache Components PPR フラグ廃止、cacheComponents: true に統合

2-2. Next.js 16.2(2026年3月):起動速度400%改善の舞台裏

コレを聞いた時はさすがに「ウソでしょ!!」って声が出ましたヨ😆 2026年3月リリースの Next.js 16.2 では next dev の起動速度が約400%改善、レンダリング速度も約50%向上しましたヨ!!

秘密はファイルシステムキャッシュの最適化と、Turbopack の内部アーキテクチャ改善デスネ💡 大きなプロジェクトほど恩恵がデカいので、業務で巨大な Next.js アプリを抱えているキミには特にオススメしたいデスヨ♪

2-3. React 19.2(2025年10月)同時リリースの意図と背景

React 19.2 は Next.js 16 と同じ2025年10月にリリースされていますヨネ🎵 これ、偶然ではなく、Vercel と React チームが足並みをそろえて「フレームワークとライブラリの進化を一緒に届ける」という意図があるワケなんデス!!

<Activity />useEffectEvent・View Transitions……どれも Next.js 16 の設計思想と深くつながっている機能なんデスネ✨ 後で詳しく解説しますヨ♪

2-4. 主要変更点を5分で把握するサマリー表

「忙しいから要点だけ!!」というキミのためにサマリー表デス🦝

カテゴリ 旧方式 新方式
バンドラー Webpack(デフォルト) Turbopack(デフォルト)
キャッシュ 暗黙的・自動 "use cache" 明示的オプトイン
ネットワーク境界 middleware.ts proxy.ts
レンダリング最適化 PPR(experimental) Cache Components(cacheComponents: true
メモ化 useMemo / useCallback 手動 React Compiler が自動化
非同期アクセス paramscookies() 同期OK 全て await が必須

3. Turbopack 安定版(Vercel):開発体験を根本から変える新バンドラー

3-1. Turbopackとは何か:Webpackとの根本的な違い

キミ、Webpack ってもう20年近くお世話になってるじゃないデスカ💾 それくらい長い付き合いのバンドラーデスが、Next.js 16 でついに世代交代となりましたヨ!!

Turbopack は Vercel が開発した Rust 製の新バンドラーで、モジュールグラフをインクリメンタルに計算するのが最大の特徴なんデスヨ💡 Webpack がファイル全体をトラバースしてビルドするのに対して、Turbopack は「変わったところだけ」を再計算するワケ。これがめちゃくちゃ速い理由なんデスネ🎵

3-2. パフォーマンス数値の読み方

公式が出している数字、コレが実にスゴいんデスヨ!!✨

  • Fast Refresh 最大10倍高速化
  • ビルド最大5倍高速化

「最大」というところがミソでサ、でかいアプリほど数字が出やすいんデスヨネ💡 中規模プロジェクト(ページ数50前後)でも Fast Refresh は体感で4〜5倍くらいは速くなりますヨ。それでも十分スゴいんだケド!!😆

3-3. ファイルシステムキャッシュ(ベータ)の仕組みと使い方

Next.js 16.2 で追加されたファイルシステムキャッシュは、ビルド結果をディスクに保存して次回起動を爆速にする機能デスヨ♪ 実際のコードがコチラデスヨ!!

// next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    turbopackPersistentCache: true, // ファイルシステムキャッシュ(ベータ)
  },
}

export default nextConfig

起動速度 400% 改善の恩恵をフルで受けたいなら、コレをオンにしておくとイイデスヨ🔥

3-4. Turbopackへの移行手順:ゼロコンフィグで始めるデフォルト設定

Next.js 16 に上げればなにもしなくても Turbopack がデフォルトになってるんデスヨ!!コレがホントにラクでサ😆 next dev を叩くだけで自動的に Turbopack が起動しますネ✨

npm run dev
# → 自動的に Turbopack で起動!
# ✓ Starting...
# ✓ Ready in 800ms

3-5. Webpack継続利用が必要なケースと --webpack フラグの使い方

「Webpack じゃないとダメなプラグインを使ってる!!」という場合もあるじゃないデスカ😭 そういう時は --webpack フラグで継続利用できますヨ♪

next dev --webpack

または next.config.ts でこう書いてもOKデスヨ!!

// next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  bundler: 'webpack',
}

export default nextConfig

まず Turbopack で試してみて、エラーが出たら --webpack にフォールバックするアプローチがオススメデスネ💡

3-6. Turbopackで起きやすいトラブルシューティング

最初に Turbopack へ移行した時、カスタムの Webpack ローダー設定をそのまま移植しようとして3時間溶かしちゃいましたヨ……やらかしちゃいましたヨ……😭 Turbopack はローダー設定の書き方が違うんデスヨネ💦

よくあるトラブルはコチラデス!!

トラブル 対処法
カスタムローダーが動かない Turbopack 向けの loaders 設定に書き換える
sass-loader が効かない experimental.turbo.loaders に設定を移す
一部のパスエイリアスが解決されない resolveAliasnext.config.ts に明示する
CSS Modules がおかしい Turbopack の CSS 処理は Webpack と挙動が異なるので公式ドキュメントを確認

4. キャッシュ刷新:"use cache" ディレクティブとISR・Cache Componentsの新設計

4-1. なぜキャッシュモデルは大幅に変わったのか:設計思想の転換

キミ、Next.js 14・15 時代のキャッシュ、正直わかりにくくなかったデスカ!!?😭 「なんで fetch がキャッシュされてるんだ!?」「なんで古いデータが出てるんだ!?」って何度も悩まされた経験、あるんじゃないデスカ……💦

旧方式(暗黙的キャッシュ)の問題点はコレデス💡

  • fetch() が黙ってキャッシュされる
  • どこでキャッシュが効いているかパッと見でわからない
  • 意図しないキャッシュヒットでバグが生まれやすい

新方式(明示的オプトイン)のメリットはこうデスヨ♪

  • "use cache" を書いた場所だけキャッシュされる
  • コードを読めばキャッシュ戦略が一目でわかる
  • デバッグしやすい🔥

4-2. "use cache" ディレクティブの基本構文と使い方

コレ見てよ!!スゴくナイ!?✨ Server Components との相性も抜群なんデスヨ!!

// app/components/ProductList.tsx
"use cache"

import { getProducts } from '@/lib/db'

export async function ProductList() {
  const products = await getProducts()

  return (
    <ul>
      {products.map((product) => (
        <li key={product.id}>
          {product.name} - ¥{product.price}
        </li>
      ))}
    </ul>
  )
}

ファイルの先頭に "use cache" を書くだけで、このコンポーネント全体がキャッシュ対象になるんデスヨ!!😆 "use server" と同じ感覚で書けるのが直感的でイイデスヨネ🎵

関数単位でキャッシュしたい場合はこうデスネ!!

// app/lib/data.ts
export async function getCachedUser(userId: string) {
  "use cache"

  const user = await fetchUserFromDB(userId)
  return user
}

4-3. PPRからCache Componentsへ:cacheComponents: true 設定の解説

Next.js 15 まであった experimental.ppr フラグ、廃止されちゃいましたヨ💦 代わりに cacheComponents: true を使うんデスネ♪ 設定はこうデスヨ!!

// next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    cacheComponents: true,
  },
}

export default nextConfig

このフラグを立てると、"use cache" ディレクティブをつけたコンポーネントが自動的に静的シェルとして先行レンダリングされて、動的部分だけ後からストリーミングされる設計になりますヨ🔥

4-4. 新キャッシュAPI 3点セット

Next.js 16 では新しいキャッシュ操作 API が追加されましたヨ!!まとめるとこんな感じデスネ💡

revalidateTag() — タグに紐づくキャッシュを全部無効化。ISR との連携が改善されて使い勝手がグッとよくなりましたヨ♪

// app/actions/revalidate.ts
'use server'

import { revalidateTag } from 'next/cache'

export async function revalidateProducts() {
  revalidateTag('products')
}

updateTag() — コレが新顔!!キャッシュを無効化せず、タグを付け替えてコントロールできる関数デスヨ✨

// app/actions/update.ts
'use server'

import { updateTag } from 'next/cache'

export async function markProductAsUpdated(productId: string) {
  updateTag(`product-${productId}`, { revalidate: 60 })
}

refresh() — コレも新機能!!キャッシュを即座にリフレッシュする関数デスヨ!!

// app/actions/refresh.ts
'use server'

import { refresh } from 'next/cache'

export async function refreshDashboard() {
  refresh() // 現在のページのキャッシュを全部リフレッシュ!
}

クライアント側からはこう使いますヨ♪

// app/components/RefreshButton.tsx
'use client'

import { refreshDashboard } from '@/app/actions/refresh'

export function RefreshButton() {
  return (
    <button onClick={() => refreshDashboard()}>
      データを更新
    </button>
  )
}

この3点セット、使いこなすとキャッシュ操作がグッとシンプルになりますヨ!!✨ ぜひ実際のプロジェクトで試してみてネ♪


5. proxy.ts:App Router時代のネットワーク境界の新しい考え方

5-1. なぜ middleware.ts は非推奨になったのか

キミ、middleware.ts って Edge Runtime で動いてたじゃないデスカ。グローバルに低レイテンシで動かせるのは良かったんデスケドね、問題もあったんデスヨ!!😭

Edge Runtime は Node.js の API を一部しか使えないんデスヨネ。fscrypto の一部、Node.js ネイティブモジュール全般——これが「認証ロジックを書こうとすると思ったより制約が多い!!」という体験につながってたんデスネ💦

proxy.ts のメリットはこうデスヨ✨

  • Node.js ランタイムで動くので制約がゆるい
  • App Router の Server Components との設計がシームレスに統合される
  • ファイル名がやりたいこと(プロキシ)を明示していてわかりやすい!!

5-2. proxy.ts の基本構文

proxy.ts はプロジェクトルート(app ディレクトリと同階層)に置きますヨ♪ 基本的な構文はコチラデスヨ!!

// proxy.ts
import { NextRequest, NextResponse } from 'next/server'

export async function proxy(request: NextRequest) {
  // リクエストを処理してレスポンスを返す
  return NextResponse.next()
}

export const config = {
  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
}

middleware.ts を知ってるキミなら、「あ、ほぼ同じ書き方だナ!!」って気づくと思いますヨ♪ エクスポートする関数名が middleware から proxy に変わっただけ——みたいなイメージでOKデスネ🎵

5-3. 認証ガード実装:proxy.ts × App Router の完全サンプル

ちなみに最近なんデスケドね、うちのチームで proxy.ts への移行をやったんデスヨ。移行作業の途中で共有のモニターが壊れてバタバタしましたが、まあ無事終わりましたヨ……そういう時に限ってトラブルが重なるもんデスヨネ😂 話を戻して——移行後のコードがこんな感じになりましたヨ!!

// proxy.ts
import { NextRequest, NextResponse } from 'next/server'
import { verifyToken, InvalidTokenError } from '@/lib/auth'

export async function proxy(request: NextRequest) {
  const protectedPaths = ['/dashboard', '/admin', '/api/protected']
  const isProtected = protectedPaths.some((path) =>
    request.nextUrl.pathname.startsWith(path)
  )

  if (!isProtected) {
    return NextResponse.next()
  }

  const token = request.cookies.get('auth-token')?.value

  if (!token) {
    return NextResponse.redirect(new URL('/login', request.url))
  }

  try {
    const payload = await verifyToken(token)
    const response = NextResponse.next()
    response.headers.set('x-user-id', payload.userId)
    return response
  } catch (error) {
    if (error instanceof InvalidTokenError) {
      const response = NextResponse.redirect(new URL('/login', request.url))
      response.cookies.delete('auth-token')
      return response
    }
    throw error
  }
}

export const config = {
  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
}

InvalidTokenError をキャッチして、トークン削除してからログインページにリダイレクト——コレが Node.js ランタイムならではのスッキリした書き方デスヨネ!!😆 Edge Runtime だと verifyToken 内で一部の Node.js 暗号ライブラリが使えなくて苦労してたんデスが、そのストレスがゼロになりましたヨ♪

5-4. middleware.ts から proxy.ts への移行チェックリスト

移行自体は難しくないんデスガ、確認ポイントをまとめておきますヨ!!✨

チェック項目 内容
ファイル名変更 middleware.tsproxy.ts
関数名変更 export function middlewareexport async function proxy
Node.js API 利用の確認 Edge Runtime でグレーだった処理が通るようになっているか確認
config.matcher の移植 設定は同じ書き方でOK
middleware.ts の削除 両ファイルが共存すると意図しない動作になるので必ず削除!!

6. React 19.2 × Server Components:<Activity />useEffectEvent・View Transitions

6-1. <Activity /> コンポーネント:非表示UIの状態を保持するServer Components連携

<Activity /> は「表示・非表示を切り替えるUIで、非表示時もコンポーネントの状態を保持できる」コンポーネントデスヨ!!😆 タブ切り替えや、モーダルの裏側のフォームとか——そういう場面で大活躍なんデスヨネ✨

使い方はこうデスネ!!

// app/components/TabPanel.tsx
'use client'

import { Activity } from 'react'

export function TabPanel({ activeTab }: { activeTab: 'profile' | 'settings' }) {
  return (
    <>
      <Activity mode={activeTab === 'profile' ? 'visible' : 'hidden'}>
        <ProfileForm />
      </Activity>
      <Activity mode={activeTab === 'settings' ? 'visible' : 'hidden'}>
        <SettingsForm />
      </Activity>
    </>
  )
}

mode="hidden" の時は DOM から消えるんじゃなくて、非表示になりながら状態を保持してくれるんデスヨ!!😭 今まで display: none で力技でやってたことが、ちゃんとサポートされましたネ♪

6-2. useEffectEvent:イベントハンドラの安定参照でuseEffectが書きやすく

useEffectEvent は「副作用の中で使うイベントハンドラを、依存配列に入れずに安定参照できる」フックデスヨ💡 わかりにくいので例で見てほしいんデスヨ!!

'use client'

import { useEffect, useEffectEvent } from 'react'

function ChatRoom({ roomId, onMessage }: { roomId: string; onMessage: (msg: string) => void }) {
  const handleMessage = useEffectEvent((message: string) => {
    onMessage(message) // onMessage が変わっても再接続しない!
  })

  useEffect(() => {
    const socket = connectToRoom(roomId)
    socket.on('message', handleMessage)
    return () => socket.disconnect()
  }, [roomId]) // roomId だけを依存配列に入れればOK!

  return <div>チャットルーム: {roomId}</div>
}

onMessage が毎レンダーで変わるコールバックだとしても、useEffectEvent でラップすれば依存配列に入れなくてイイんデスヨ!!😆 リント警告とも戦わなくて済むようになりましたヨ♪

6-3. View Transitions API統合:App Routerのページ遷移が別次元になるヨ

View Transitions API が React 19.2 でネイティブサポートされましたヨ!!✨ App Router のナビゲーションにそのまま適用できるんデスヨネ🎵

// app/components/TransitionLink.tsx
'use client'

import { Link } from 'next/link'
import { useViewTransition } from 'react'

export function TransitionLink({ href, children }: { href: string; children: React.ReactNode }) {
  const { startTransition } = useViewTransition()

  return (
    <Link
      href={href}
      onClick={(e) => {
        e.preventDefault()
        startTransition(() => {
          window.location.href = href
        })
      }}
    >
      {children}
    </Link>
  )
}

CSS でアニメーションを定義するだけで、ページ遷移がヌルッと動くようになりますヨ!!😆 ネイティブアプリみたいなUXが Web でも実現できる時代になってきましたネ💡


7. React Compiler 安定版:App Router時代の自動メモ化で変わる開発スタイル

7-1. React Compiler が何を自動化するのか

React Compiler は useMemouseCallbackmemo()自動的に挿入してくれるコンパイラーデスヨ!!😆 今まで手動でやってた「このコンポーネント、再レンダー多そうだから memo 巻こう」という作業がいらなくなるワケデスネ✨

具体的には、こういうコードを書いたとして——

// before: 手動メモ化が必要だった
function ProductCard({ product, onAdd }: { product: Product; onAdd: (id: string) => void }) {
  const formattedPrice = formatPrice(product.price) // 毎レンダー実行されてた

  return (
    <div>
      <h2>{product.name}</h2>
      <p>{formattedPrice}</p>
      <button onClick={() => onAdd(product.id)}>カートに追加</button>
    </div>
  )
}

React Compiler がコンパイル時に、formattedPrice の計算や onClick コールバックを自動的にメモ化してくれますヨ!!コードはシンプルなまま、パフォーマンスはちゃんと最適化されてるんデスヨネ♪

7-2. 有効化の設定方法

Next.js 16 での設定はシンプルデスヨ!!

// next.config.ts
import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    reactCompiler: true,
  },
}

export default nextConfig

package.jsonbabel-plugin-react-compiler も入れておきましょうネ!!

npm install --save-dev babel-plugin-react-compiler

7-3. 手動最適化との使い分け

「じゃあ useMemo とか全部消していいの!?」ってなるじゃないデスカ😆 基本的にはReact Compiler に任せてOKなんデスガ、外部ライブラリとの兼ね合いや、超複雑な計算ロジックでは手動で useMemo を残すことも検討してほしいんデスヨネ💡

迷ったらまず React Compiler だけオンにして、パフォーマンス計測してから手動最適化を検討するアプローチがオススメデスヨ♪


8. 実践ユースケース:App Router × Server Components × Vercel シナリオ別実装パターン集

8-1. ECサイト:商品一覧ページのISR実装

商品一覧は「たまに更新される、でも毎リクエストで DB 叩く必要はない」典型的なISRユースケースデスヨネ💡 Next.js 16 の "use cache" との組み合わせがこんな感じデス!!

// app/products/page.tsx
import { ProductList } from '@/components/ProductList'
import { revalidateTag } from 'next/cache'

export default async function ProductsPage() {
  return (
    <main>
      <h1>商品一覧</h1>
      <ProductList />
    </main>
  )
}
// app/components/ProductList.tsx
"use cache"
import { unstable_cacheTag as cacheTag, unstable_cacheLife as cacheLife } from 'next/cache'
import { getProducts } from '@/lib/db'

export async function ProductList() {
  cacheTag('products')
  cacheLife('hours') // 1時間キャッシュ

  const products = await getProducts()

  return (
    <ul>
      {products.map((product) => (
        <li key={product.id}>
          {product.name} - ¥{product.price.toLocaleString()}
        </li>
      ))}
    </ul>
  )
}

商品データが更新されたら revalidateTag('products') を呼ぶだけで、Vercel のエッジキャッシュも含めて一括更新されますヨ!!😆

8-2. 管理ダッシュボード:Server Components × Suspense でリアルタイムストリーミング

ダッシュボードって「いくつかのウィジェットが独立してデータ取得する」設計じゃないデスカ💡 Server Components と Suspense の組み合わせが本領発揮するシーンデスヨ!!

// app/dashboard/page.tsx
import { Suspense } from 'react'
import { SalesChart } from '@/components/SalesChart'
import { UserStats } from '@/components/UserStats'
import { RecentOrders } from '@/components/RecentOrders'

export default function DashboardPage() {
  return (
    <div className="dashboard-grid">
      <Suspense fallback={<ChartSkeleton />}>
        <SalesChart />
      </Suspense>
      <Suspense fallback={<StatsSkeleton />}>
        <UserStats />
      </Suspense>
      <Suspense fallback={<OrdersSkeleton />}>
        <RecentOrders />
      </Suspense>
    </div>
  )
}

各コンポーネントが並列でデータ取得して、準備できたものからストリーミングで届くんデスヨ!!✨ ページ全体の読み込みを待たなくていいのが最高デスネ♪

8-3. 認証が必要なアプリ:proxy.ts × Server Actions の組み合わせ

認証付きアプリの定番パターンをまとめるとこうデスヨ!!💡 proxy.ts で入口を守って、Server Actions でデータ操作するデスネ♪

// app/actions/profile.ts
'use server'

import { cookies } from 'next/headers'
import { verifyToken } from '@/lib/auth'
import { updateUserProfile } from '@/lib/db'

export async function updateProfile(formData: FormData) {
  const cookieStore = await cookies()
  const token = cookieStore.get('auth-token')?.value

  if (!token) throw new Error('Unauthorized')

  const payload = await verifyToken(token)
  const name = formData.get('name') as string

  await updateUserProfile(payload.userId, { name })
}

proxy.ts で認証チェックしてるんデスガ、Server Actions 側でも再検証するのが鉄則デスヨ!!多層防御ってやつデスネ🔥


9. Next.js 16 移行ガイド:App Router移行の破壊的変更と対処法

9-1. 主な破壊的変更一覧

Next.js 15 から16への移行で注意が必要な破壊的変更をまとめましたヨ!!😭

変更点 対処法
params が非同期化 const { id } = await params に書き換え
cookies() / headers() が非同期化 await cookies() / await headers() に変更
middleware.ts 非推奨 proxy.ts に移行
experimental.ppr 廃止 experimental.cacheComponents: true に変更
fetch の自動キャッシュ廃止 明示的に "use cache" を追加
Node.js 18 サポート終了 Node.js 20.9 以上に更新

9-2. paramscookies の非同期化対応

コレが一番ハマりやすいポイントなんデスヨ!!😆 params が同期アクセスできなくなりましたネ♪

// before(Next.js 15)
export default function ProductPage({ params }: { params: { id: string } }) {
  const { id } = params // 同期アクセスOKだった
  // ...
}

// after(Next.js 16)
export default async function ProductPage({ params }: { params: Promise<{ id: string }> }) {
  const { id } = await params // await が必須!!
  // ...
}

cookies() も同様デスヨ!!

// before
import { cookies } from 'next/headers'
const cookieStore = cookies() // 同期アクセス

// after
const cookieStore = await cookies() // await が必須!!

9-3. codemod で自動対応する方法

手作業でやると漏れが出るんデスヨネ……やらかしちゃいましたヨ……😭 Next.js が提供している codemod を使いましょう!!

# Next.js 16 向けの codemod を一括実行
npx @next/codemod@latest next-async-request-api .
npx @next/codemod@latest use-cache-directive .

ほとんどの機械的な変換はこれで片付きますヨ!!✨ 残った手動対応箇所は TypeScript のエラーが教えてくれますネ♪

9-4. 移行時の動作確認チェックリスト

移行後に確認してほしいポイントデスヨ!!💡

  • npm run build がエラーなく通るか
  • 動的ページ([id] 等)で paramsawait が正しく機能しているか
  • 認証フローが proxy.ts に移行後も正常に動作するか
  • "use cache" をつけたコンポーネントが意図した通りにキャッシュされているか
  • Vercel にデプロイして実環境でのパフォーマンスを計測したか

10. まとめ:Next.js 16 × App Router 時代のフルスタック開発戦略

10-1. この記事で学んだことの振り返り

長かったデスが、ここまで読んでくれてありがとうございますヨ、キミ!!😆 最後にまとめてみましょうネ🎵

テーマ ポイント
Turbopack Vercel製Rust製バンドラーでFast Refresh最大10倍高速化、デフォルトで有効
"use cache" キャッシュは明示的オプトインに刷新。Server ComponentsとISRとの連携が洗練された
proxy.ts Node.jsランタイムでApp Routerのネットワーク境界を担う新ファイル
React 19.2 <Activity />useEffectEvent・View TransitionsでServer Components体験が進化
React Compiler 自動メモ化が安定版に。App Router時代の手動最適化コストが大幅削減
移行 codemodで機械的変換、params/cookiesawait対応が最大の注意点

10-2. Next.js 16時代のアーキテクチャ選択指針

「で、結局どういう設計にすればイイの?」というキミへのアドバイスデスヨ!!✨

静的コンテンツ主体のサイト(ブログ・ドキュメント・LP)→ "use cache" + cacheLife でISRを明示的に管理。Vercelのエッジキャッシュと組み合わせると最強デスネ!!

インタラクティブなアプリ(ダッシュボード・管理画面)→ Server Components × Suspense のストリーミング構成 + proxy.ts 認証ガード。Server Actionsとセットで設計するのがオススメデスヨ♪

ECサイト(商品一覧 + カート + 決済)→ 商品一覧は "use cache" でISR、カート・決済フローは Server Actions 管理。updateTag でキャッシュを細かくコントロールするのがポイントデスネ💡

10-3. 次のステップ:キミへのアクションアイテム

最後に、今日から動けるアクションアイテムを渡しておきますヨ!!😭

  1. まずアップデートnpm exec -- create-next-app@latest で素振り環境を作って Next.js 16 を触ってみよう
  2. "use cache" を1箇所だけ書いてみる — 既存プロジェクトの一番重いデータ取得コンポーネントに付けるだけでOK!!
  3. proxy.ts に移行してみるmiddleware.tsproxy.ts にリネームして関数名を変えるだけ。まずやってみるデスヨ♪
  4. React Compiler をオンreactCompiler: true の1行だけ。パフォーマンス計測してみてネ✨

Next.js 16 × React 19.2 の時代、最初はとっつきにくく感じることもあると思うんデスヨ。でも「意図をコードに書く」という設計思想に慣れたら、絶対に開発体験が別次元になるんデスヨネ!!😆

キミのプロダクトが、Next.js 16 でさらに素晴らしくなることを応援していますヨ!!✨ わからないことがあったらまた記事を読み返してネ♪


この記事はNext.js 16.2・React 19.2時点の情報をもとに執筆しています。最新情報はNext.js公式ドキュメントおよびReact公式ドキュメントをご確認くださいネ!!

コメント

0/2000