Next.js 16 Launchpad は何をしますか?
Next.js 16: Turbopack がデフォルトに(ビルドが 2~5 倍高速化)、Cache Components('use cache')、proxy.ts による明示的な制御。
使用するタイミング
✅ Next.js 16、Turbopack、Cache Components、proxy 移行、App Router、React 19.2
❌ Pages Router、Next.js ≤15、一般的な React の質問
必要条件
| ツール | バージョン |
|---|---|
| Node.js | 20.9.0+ |
| TypeScript | 5.1.0+ |
| React | 19.2+ |
クイックスタート
# 新規プロジェクト
npx create-next-app@latest my-app
# 既存プロジェクトのアップグレード
npx @next/codemod@canary upgrade latest
npm install next@latest react@latest react-dom@latest
推奨: TypeScript、ESLint、Tailwind、App Router、Turbopack、@/* エイリアス。
最小限のセットアップ
// app/layout.tsx
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}
// app/page.tsx
export default function Page() {
return <h1>Hello, Next.js 16!</h1>
}
設定
// next.config.ts
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
cacheComponents: true,
reactCompiler: true,
}
export default nextConfig
v15 → v16 の変更点
| v15 | v16 |
|---|---|
experimental.turbopack | デフォルト有効 |
experimental.ppr | cacheComponents |
middleware.ts (Edge) | proxy.ts (Node) |
同期 params | await params |
コアパターン
1. サーバーコンポーネント(デフォルト)
export default async function BlogPage() {
const res = await fetch('https://api.example.com/posts')
const posts = await res.json()
return <PostList posts={posts} />
}
2. Cache Components
import { cacheLife } from 'next/cache'
export default async function BlogPage() {
'use cache'
cacheLife('hours')
const posts = await fetch('https://api.example.com/posts').then(r => r.json())
return <PostList posts={posts} />
}
3. クライアントコンポーネント
'use client'
import { useState } from 'react'
export default function Counter() {
const [count, setCount] = useState(0)
return (
<div>
<p>Count: {count}</p>
<button onClick={() => setCount(count + 1)}>+</button>
</div>
)
}
4. プロキシバウンダリ
// app/proxy.ts
export function proxy(request: NextRequest) {
if (!request.cookies.get('auth') && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
return NextResponse.next()
}
5. Cache Tags + サーバーアクション
// app/blog/page.tsx
'use cache'
cacheLife('hours')
cacheTag('blog-posts')
export default async function BlogList() {
const posts = await db.posts.findMany()
return <PostList posts={posts} />
}
// app/actions.ts
'use server'
import { updateTag } from 'next/cache'
export async function createPost(data: PostData) {
await db.posts.create(data)
updateTag('blog-posts')
}
6. Suspense を使ったストリーミング
export default function Dashboard() {
return (
<div>
<Suspense fallback={<Skeleton />}>
<RevenueCard />
</Suspense>
<Suspense fallback={<Skeleton />}>
<UsersCard />
</Suspense>
</div>
)
}
async function RevenueCard() {
const data = await db.analytics.revenue()
return <div>{data}</div>
}
主要なコンセプト
- Turbopack - Rust 製バンドラー、インクリメンタルコンパイル、Fast Refresh
- サーバーコンポーネント -
app/内ではデフォルト、クライアント JS ゼロ - クライアントコンポーネント -
'use client'、フック、ブラウザ API - Cache Components -
'use cache'+cacheLife()による PPR - プロキシバウンダリ -
proxy.tsによる認証/リライト/リダイレクト - 部分プリレンダリング - 静的シェル + 動的ストリーミング
移行チェックリスト
-
非同期リクエスト API
npx @next/codemod@canary async-request-api更新:
const { slug } = await params -
middleware.ts → proxy.ts
- ファイル名を変更し、
proxyをエクスポート - Node ランタイムのみ(Edge ではない)
- ファイル名を変更し、
-
設定の更新
experimental.*フラグを削除cacheComponents、reactCompilerを有効化serverRuntimeConfig/publicRuntimeConfigを削除
-
Cache Components
experimental.pprをcacheComponents: trueに置き換え- 動的セクションを
<Suspense>でラップ
-
画像
- クエリ文字列のために
images.localPatternsを設定
- クエリ文字列のために
完全なガイドは references/nextjs16-migration-playbook.md を参照してください。
よくある落とし穴
❌ 'use cache' とランタイム API(cookies()、headers())の混在
❌ Cache Components を有効にした際の <Suspense> の欠落
❌ Turbopack 下でのチルダ Sass インポート
❌ Edge ランタイムでの proxy.ts の実行
✅ cookies/headers を先に読み取り、キャッシュされたコンポーネントに props として渡す
✅ 動的な子要素を <Suspense> でラップ
✅ 標準の Sass インポートを使用する
✅ プロキシには Node ランタイムを使用する
判断ガイド
Cache Components を有効にしますか? → 静的/準静的なコンテンツには「はい」 → 完全に動的なダッシュボードには「いいえ」
認証はどこに置きますか?
→ ルート間のチェックには proxy.ts
→ API 固有のロジックにはルートハンドラ
いつ 'use client' を使用しますか?
→ フック、状態、またはブラウザ API が必要な場合のみ
→ プレゼンテーション用コンポーネントはサーバーサイドに維持
プロダクションパターン
E コマース
// ストリーミングを使用した商品ページ
export default async function Product({ params }) {
const { id } = await params
const product = await db.products.findById(id)
return (
<>
<ProductInfo product={product} />
<Suspense fallback={<ReviewsSkeleton />}>
<Reviews productId={id} />
</Suspense>
</>
)
}
認証付きダッシュボード
// proxy.ts
export function proxy(request: NextRequest) {
const session = request.cookies.get('session')
if (!session && request.nextUrl.pathname.startsWith('/dashboard')) {
return NextResponse.redirect(new URL('/login', request.url))
}
}
詳細な設計図については references/nextjs16-advanced-patterns.md を参照してください。
パフォーマンス
- Turbopack を有効にしたままにする(必要な場合のみ
--webpackで無効化) Promise.allでフェッチを並列化- ストリーミング境界に
<Suspense>を使用 - 大規模リポジトリではファイルシステムキャッシュを有効化
セキュリティ
server-onlyパッケージと React Taint API を使用- 認証は
proxy.tsに維持 - サーバーアクションで入力を検証
- 環境変数は
NEXT_PUBLIC_プレフィックスでゲート - キャッシュスコープの前に cookies/headers を抽出
デプロイ
- Vercel: ゼロ設定
- Docker/Node:
output: 'standalone' - ビルド時間を監視(2~5 倍の高速化を想定)
- CDN に合わせてキャッシュライフサイクルを設定
参照ファイル
- references/nextjs16-reference.md - インストール/設定/チェックリスト
- references/nextjs16-migration-playbook.md - コードモッドを使用した移行ガイド
- references/nextjs16-advanced-patterns.md - ストリーミング、キャッシュ、認証パターン
- references/NEXTJS_16_COMPLETE_GUIDE.md - 完全なドキュメント
- scripts/bootstrap-nextjs16.ps1 - 自動セットアップスクリプト
- assets/app-router-starter/ - リファレンス実装
リソース
- ドキュメント: https://nextjs.org/docs
- GitHub: https://github.com/vercel/next.js
バージョン: 1.1.0 | 更新日: 2025-12-27