Laravel 中解决 N+1 查询问题需用关联预加载:一、基础 with('relation');二、多关系 with(['a','b']);三、嵌套 with('a.b');四、条件 with(['r'=>fn($q)=>$q->where(...)]);五、延迟 load('r')。

如果您在 Laravel 应用中频繁遭遇接口响应迟缓、数据库查询次数激增,很可能是由未处理的 N+1 查询引发。以下是针对关联模型预加载的多种具体操作方式:
一、基础预加载:使用 with() 一次性加载一级关联
该方法适用于主模型数量可控、且需统一展示关联字段的场景。Eloquent 将主表查询与各关联表查询分离执行,利用 IN 子句批量获取关联数据,避免循环内逐条查询。
1、在控制器中调用 Eloquent 查询时,直接链式添加 with() 方法,并传入字符串形式的关系名。
2、例如获取全部文章及其作者信息:$posts = App\Models\Post::with('user')->get();
3、视图中可安全访问 $post->user->name,不再触发额外 SQL。
二、多关系并列预加载:同时加载多个一级关联
当一个主模型需展示多个独立关联(如用户、分类、标签),可将多个关系名以数组形式传入 with(),Laravel 会为每个关系发起一次独立的预加载查询,确保所有字段可用。
1、编写查询语句:$posts = App\Models\Post::with(['user', 'category', 'tags'])->get();
2、注意:每个关系必须已在对应模型中正确定义为 Eloquent 关系方法(如 hasOne、hasMany、belongsToMany)。
3、验证生成 SQL:启用 DB::enableQueryLog() 后执行,确认仅出现 4 条查询(主表 + user + category + tags)。
三、嵌套预加载:加载深层关联关系
用于访问“关联的关联”,例如文章 → 作者 → 头像,或商品 → 分类 → 父分类。必须使用点号语法声明完整路径,不可拆分为多个 with() 调用,否则中间层关系不会被加载。
1、正确写法:$posts = App\Models\Post::with('user.avatar')->get();
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
2、错误写法:$posts = App\Models\Post::with('user')->with('avatar')->get(); —— 此时 avatar 不属于 Post 模型关系,将被忽略。
3、访问时可安全使用 $post->user->avatar->url,无额外查询发生。
四、条件预加载:按需筛选关联数据
当仅需加载关联表中的部分记录(如只取最新一条评论、只查已激活的配置),可在 with() 的闭包回调中限定查询条件,减少内存与传输开销。
1、定义带条件的预加载:$posts = App\Models\Post::with(['comments' => function ($query) { $query->where('status', 'approved')->latest()->limit(1); }])->get();
2、确保闭包内使用 where、orderBy、limit 等构建器方法,而非 get() 或 first()。
3、注意:条件预加载不改变主模型结果集,仅影响预加载内容本身。
五、延迟预加载:对已有模型实例补载关联
适用于模型已在内存中存在(如从缓存取出、或前序逻辑已查出),但后续业务分支才决定是否需要某关联数据。此时用 load() 替代 with(),避免无谓预加载。
1、先获取主模型集合:$users = App\Models\User::where('active', 1)->get();
2、在特定分支中按需加载:if ($needProfile) { $users->load('profile'); }
3、多次调用同一关系的 load() 将重复执行 SQL,请自行判断是否已加载或加缓存防护。

















