Next.js ベストプラクティス
Next.js App Router 開発のための原則
1. サーバーコンポーネント vs クライアントコンポーネント
決定木
必要とするものは...?
│
├── useState, useEffect, イベントハンドラ
│ └── クライアントコンポーネント ('use client')
│
├── 直接データフェッチ、インタラクティブではない
│ └── サーバーコンポーネント (デフォルト)
│
└── 両方?
└── 分割:サーバー親 + クライアント子
デフォルトの使い分け
| タイプ | 使用例 |
|---|
| サーバー | データフェッチ、レイアウト、静的コンテンツ |
| クライアント | フォーム、ボタン、インタラクティブUI |
2. データフェッチパターン
フェッチ戦略
| パターン | 使用例 |
|---|
| デフォルト | 静的(ビルド時にキャッシュ) |
| Revalidate | ISR(時間ベースの更新) |
| No-store | 動的(リクエストごとに実行) |
データフロー
| ソース | パターン |
|---|
| データベース | サーバーコンポーネントでフェッチ |
| API | キャッシュ付きfetch |
| ユーザー入力 | クライアント状態 + サーバーアクション |
3. ルーティングの原則
ファイル規約
| ファイル | 目的 |
|---|
page.tsx | ルートUI |
layout.tsx | 共有レイアウト |
loading.tsx | ローディング状態 |
error.tsx | エラーバウンダリ |
not-found.tsx | 404ページ |
ルート構成
| パターン | 使用例 |
|---|
ルートグループ (name) | URLに影響を与えずに整理 |
パラレルルート @slot | 同じ階層の複数ページ |
インターセプト (.) | モーダルオーバーレイ |
4. APIルート
ルートハンドラ
| メソッド | 使用例 |
|---|
| GET | データ読み取り |
| POST | データ作成 |
| PUT/PATCH | データ更新 |
| DELETE | データ削除 |
ベストプラクティス
- 入力をZodで検証する
- 適切なステータスコードを返す
- エラーを適切に処理する
- 可能な場合はEdgeランタイムを使用する
5. パフォーマンスの原則
画像最適化
- next/imageコンポーネントを使用する
- ファーストビューにはpriorityを設定する
- ブラーフプレースホルダを用意する
- レスポンシブサイズを使用する
バンドル最適化
- 重いコンポーネントには動的インポート
- ルートベースのコード分割(自動)
- バンドルアナライザで分析する
6. メタデータ
静的 vs 動的
| タイプ | 使用例 |
|---|
| 静的エクスポート | 固定メタデータ |
| generateMetadata | ルートごとに動的生成 |
必須タグ
- title(50〜60文字)
- description(150〜160文字)
- Open Graph画像
- 正規URL
7. キャッシュ戦略
キャッシュレイヤー
| レイヤー | 制御方法 |
|---|
| リクエスト | fetchオプション |
| データ | revalidate/tags |
| フルルート | ルート設定 |
再検証
| 方法 | 使用例 |
|---|
| 時間ベース | revalidate: 60 |
| オンデマンド | revalidatePath/Tag |
| キャッシュなし | no-store |
8. サーバーアクション
ユースケース
ベストプラクティス
- 'use server'でマークする
- すべての入力を検証する
- 型付きレスポンスを返す
- エラーを処理する
9. アンチパターン
| ❌ やらないこと | ✅ やること |
|---|
| あらゆる場所で'use client' | デフォルトでサーバー |
| クライアントコンポーネントでフェッチ | サーバーでフェッチ |
| ローディング状態をスキップ | loading.tsxを使用 |
| エラーバウンダリを無視 | error.tsxを使用 |
| 大きなクライアントバンドル | 動的インポート |
10. プロジェクト構造
app/
├── (marketing)/ # ルートグループ
│ └── page.tsx
├── (dashboard)/
│ ├── layout.tsx # ダッシュボードレイアウト
│ └── page.tsx
├── api/
│ └── [resource]/
│ └── route.ts
└── components/
└── ui/
覚えておいてください: サーバーコンポーネントがデフォルトであるのには理由があります。まずはそこから始め、必要な場合にのみクライアントを追加しましょう。