N+1クエリを修正し、Eloquentを最適化するにはどうすればよいですか？

Question

Accepted Answer

**N+1クエリ問題** — ループ内でリレーションシップにアクセスするときにレコードごとに個別のクエリが実行される問題 — はEloqeuntで最も一般的なパフォーマンス問題です。`with()`による**先読み込み(Eager loading)**が主な修正方法であり、他の最適化(列選択、チャンキング、インデックス)と並行して使用します。

## N+1問題とその修正

```php
// ❌ N+1: 1 query for posts + 1 query PER post to load its author
$posts = Post::all();                         // 1 query
foreach ($posts as $post) {
    echo $post->author->name;                  // +1 query EACH → 100 posts = 101 queries!
}

// ✅ eager load with with() → 2 queries total (posts + all authors)
$posts = Post::with('author')->get();
foreach ($posts as $post) {
    echo $post->author->name;                  // no extra queries — authors prefetched
}
```

**`with()`** はリレーションシップを事前に先読み込みします(レコードごとに1クエリではなく、リレーションシップごとに1追加クエリ)。101クエリが2クエリに変わります — 劇的な改善です。これはEloqeuntにおける本質的な最適化です。

## 先読み込みのバリエーション

```php
Post::with(['author', 'comments'])->get();        // multiple relationships
Post::with('comments.user')->get();                // nested
Post::with(['comments' => fn($q) => $q->latest()])->get();   // constrained
User::withCount('posts')->get();                   // count without loading (post_count)
```

## N+1の自動検出

```php
// in development, make lazy loading THROW so you catch N+1 problems early
Model::preventLazyLoading();    // in a service provider (dev)
// or use Laravel Debugbar / Telescope to see query counts per request
```

**Debugbar/Telescope**のようなツールはページごとのクエリ数を表示し(N+1を視覚的に検出)、`preventLazyLoading()`は開発時の偶然の遅延読み込みをエラーに変えます。

## その他のEloquent最適化

```php
User::select('id', 'name')->get();             // fetch only needed columns
User::chunk(1000, fn($users) => ...);           // process huge sets in batches (memory)
User::cursor();                                  // lazy iteration — constant memory
// + add database INDEXES on filtered/joined columns (the biggest DB-level win)
// + use the query builder / database aggregation instead of PHP loops over collections
```

## なぜ重要なのか

N+1クエリを修正し、Eloquentを最適化することはLaravelアプリケーションのパフォーマンスに必要不可欠な知識です — **N+1クエリ問題はLaravelで単一で最も一般的で影響力のあるパフォーマンス問題**であり、これを防ぐ方法を理解することは不可欠です。

この問題が厄介なのは、Eloquentの便利なリレーションシップアクセス(`$post->author`)が毎回サイレントにデータベースクエリを実行するため、少量のデータでは問題なく動作するコードが、データ増加に伴って激速で劣化します(100レコードが101クエリになり、多くの場合は本番環境での負荷がかかる状態で初めて発見されます)。**`with()`による先読み込み** — リレーションシップを数クエリで事前に読み込むのではなく、レコードごとに1クエリ — が本質的な修正です。バリエーション(複数、ネスト、制約付き先読み込み、`withCount`)を知ることで一般的なニーズをカバーします。

同様に重要なのは、**N+1問題を検出する**方法を知ることです(Debugbar/Telescopeでクエリ数を表示、`preventLazyLoading()`で開発時に偶然の遅延読み込みをエラーに変える)。これにより本番環境の前に問題を見つけられます。

N+1を超えて、他の最適化 — 必要な列だけを選択、**チャンキング/カーソル**で大規模データセット処理時にメモリ枯渇なし、PHP側のコレクション処理ではなくデータベース集計、そして決定的に重要な**インデックス** (フィルターされた/結合された列へのインデックス — しばしば最大のデータベースレベルの勝利) — がツールキットを完成させます。

これらを理解すること — 特に先読み込みによるN+1の認識と修正 — はシニアレベルの重要な知識です。これはパフォーマンスに優れたLaravelアプリケーションを書く開発者と、データ増加に伴ってアプリケーションが低速化する開発者を区別します。スケーラブルなアプリケーション構築のための頻繁に関連する高い価値のあるトピックとなります。