Laravel关联查询怎么优化

本文目录导读：

1. 核心原则：避免 N+1 查询
2. 常见优化技巧
3. 大数据量查询优化
4. 数据库层面优化
5. 高级技巧
6. 性能分析工具
7. 实际案例优化对比
8. 总结优化清单

Laravel 关联查询优化是提升应用性能的关键，下面我会从核心原则到具体实践,系统地为你梳理优化方案。

核心原则：避免 N+1 查询

这个问题最常见且影响最大，当你在循环中访问关联模型时，Laravel 会为每次访问都执行一次 SQL 查询。

❌ 坏例子（N+1 问题）

$posts = Post::all();
foreach ($posts as $post) {
    echo $post->user->name; // 每次循环都执行一次 SQL 查询
}

$posts 有 100 条，就会产生 1（查 posts）+ 100（查 users）= 101 次查询。

✅ 好例子：使用 with() 预加载

$posts = Post::with('user')->get();
foreach ($posts as $post) {
    echo $post->user->name; // 只执行 2 次查询（1次查posts，1次查users）
}

常见优化技巧

精确选择需要的字段

// ❌ 低效：查询了所有字段
$posts = Post::with('user')->get();
// ✅ 高效：只查询需要的字段
$posts = Post::with(['user' => function ($query) {
    $query->select('id', 'name'); // 注意：必须包含关联键（通常是 id）
}])->get();
// 或使用更简洁的语法（需要装可选包）
$posts = Post::with('user:id,name')->get();

按需加载（延迟预加载）

当你不确定是否需要关联数据时：

$posts = Post::get(); // 先不加载关联
// 当确实需要时
if ($needUserInfo) {
    $posts->load('user'); // 按需加载
}

使用 loadCount 替代 load

如果你只需要关联的数量,而不是所有数据：

// ❌ 低效
$posts = Post::with('comments')->get();
foreach ($posts as $post) {
    echo $post->comments->count(); // 加载了所有评论数据，只为计数
}
// ✅ 高效
$posts = Post::withCount('comments')->get();
foreach ($posts as $post) {
    echo $post->comments_count; // 只执行一次 count 查询
}

嵌套关联的优化

// 多级关联
$users = User::with(['posts.comments' => function ($query) {
    $query->where('approved', 1); // 可以在预加载时就过滤
}])->get();

大数据量查询优化

使用延迟加载（Cursor）

// ❌ 可能内存溢出
$users = User::with('profile')->get(); // 一次性加载所有
// ✅ 分批处理（低内存占用）
User::with('profile')->chunk(100, function ($users) {
    foreach ($users as $user) {
        // 处理用户...
    }
});
// ✅ 使用游标（更高效）
foreach (User::with('profile')->cursor() as $user) {
    // 逐条处理
}

选择性预加载

// 只加载有评论的文章
$posts = Post::with(['comments' => function ($query) {
    $query->where('created_at', '>', now()->subDays(7));
}])->whereHas('comments')->get();

数据库层面优化

添加合适的索引

// 在迁移文件中
Schema::table('comments', function (Blueprint $table) {
    $table->index('post_id'); // 外键索引
    $table->index(['post_id', 'created_at']); // 复合索引
});

使用原生查询（必要时）

// 有时 Eloquent ORM 的开销过大，可以用 DB 门面
$users = DB::table('users')
    ->join('profiles', 'users.id', '=', 'profiles.user_id')
    ->select('users.*', 'profiles.bio')
    ->where('profiles.visibility', 'public')
    ->get();

高级技巧

使用 eagerLoad 全局生效

// 在 Model 中定义
class Post extends Model
{
    /**
     * 需要被本模型预加载的关联。
     */
    protected $with = ['user', 'category'];
}

警告：这个会全局生效，慎用！通常只用于“几乎所有场景都需要的关联”。

使用 withCount 的排序

// 按评论数排序
$posts = Post::withCount('comments')
    ->orderBy('comments_count', 'desc')
    ->get();

关联数量的条件过滤

// 获取有至少3条评论的文章
$posts = Post::has('comments', '>=', 3)->get();
// 获取有评论且评论来自不同用户
$posts = Post::whereHas('comments', function ($query) {
    $query->whereColumn('user_id', '<>', 'comments.user_id');
})->get();

性能分析工具

Laravel Debugbar（推荐）

composer require barryvdh/laravel-debugbar --dev

安装后可以看到每次请求执行的 SQL 查询数量和耗时。

日志记录慢查询

在 AppServiceProvider 中：

public function boot()
{
    DB::listen(function ($query) {
        if ($query->time > 100) { // 超过100ms
            Log::info('Slow Query', ['sql' => $query->sql, 'bindings' => $query->bindings]);
        }
    });
}

实际案例优化对比

复杂场景：文章列表 + 用户信息 + 评论数 + 标签

// ❌ 原始写法（N+1 + 重复查询）
$posts = Post::all();
foreach ($posts as $post) {
    $post->user;         // N次查询
    $post->comments;     // N次查询（实际只需要count）
    $post->tags;         // N次查询
}
// ✅ 优化后
$posts = Post::with([
    'user:id,name,avatar',  // 只取必要字段
    'tags:name',            // 只取标签名称
])->withCount('comments')   // 只统计数量，不加载数据
->orderBy('published_at', 'desc')
->paginate(15);

总结优化清单

场景	优化方法	效果
循环中访问关联	with() 预加载	N+1 → 2N
只需关联数量	withCount()	避免加载数据
多级嵌套关联	嵌套 with()	减少查询轮数
大结果集	chunk() / cursor()	降低内存占用
只需特定字段	select()	减少数据传输量
性能监控	Debugbar / Query Log	发现瓶颈

最佳实践：先写业务逻辑，然后用 Debugbar 观察 SQL 数量，再针对性优化,避免过度优化导致代码可读性下降。