你如何修复 N+1 查询并优化 Eloquent？

Question

Accepted Answer

**N+1 查询问题** — 在循环中访问关系会为每条记录触发一个单独的查询 — 是最常见的 Eloquent 性能问题。使用 `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()`** 预先 eager-load 关系（每个关系一个额外查询，而不是每条记录一个），将 101 个查询变成 2 个 — 有显著改进。这是基本的 Eloquent 优化。

## Eager loading 的各种用法

```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()` 在开发时将意外的 lazy load 转为错误。

## 其他 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()` 的 eager loading** 是基本解决方案 — 在几个查询中预先加载关系，而不是每条记录一个 — 知道其变种（多个、嵌套、受限的 eager load、`withCount`）涵盖了常见需求。

同样重要的是知道如何 **捕获 N+1 问题**（Debugbar/Telescope 查看查询数量，`preventLazyLoading()` 在开发中将意外 lazy load 转为错误），以便在进入生产环境前找到它们。

除了 N+1，其他优化 — 仅选择需要的列、**分块/游标**在不耗尽内存的情况下处理大型数据集、数据库聚合而非 PHP 端的集合处理、最关键的是**索引化**过滤/连接列（通常是最大的数据库级收益）— 完整了工具包。

理解这些 — 尤其是识别和修复 N+1 与 eager loading — 是重要的高级知识，它区分了编写高性能 Laravel 应用的开发者和那些应用随着数据增长而陷入困境的开发者，使其成为一个频繁相关、高价值的主题，用于构建可扩展的应用。