laravel中应使用with()预加载避免n+1查询:支持单关联、嵌套关联、带条件预加载,但limit/take在闭包中无效,多对多需distinct去重。

如果您在 Laravel 应用中处理模型关联时发现数据库查询次数激增、响应变慢,则很可能是未正确使用预加载机制。with() 是 Eloquent 实现 eager loading 的核心方法,用于在主查询阶段一并获取关联数据,从而避免 N+1 查询问题。以下是具体使用方式:
一、基础语法与单关联预加载
with() 方法接受字符串或数组参数,指定需预加载的一级关联关系。它会在执行主模型查询后,立即发起一条或多条独立的关联查询,通过 IN 条件批量获取数据,而非逐个触发。
1、在查询构建器上调用 with(),传入关联名字符串:User::with('posts')->get()。
2、对多个一级关联同时预加载,传入关联名数组:User::with(['posts', 'profile'])->get()。
3、调用后访问关联属性不会触发新查询,例如遍历 $users 时读取 $user->posts->count() 不再产生额外 SQL。
二、嵌套关联预加载
当关联模型自身还存在深层关系(如 Post 属于 User,且 Post 有多个 Comment),可通过点号语法声明嵌套路径,Eloquent 将按层级顺序依次预加载各层数据,确保整条关系链仅用最少查询完成。
1、加载用户及其文章,再加载每篇文章的评论:User::with('posts.comments')->get()。
2、混合加载不同深度的关联:User::with(['posts', 'posts.tags', 'profile.avatar'])->get()。
3、嵌套结构中任一环节未定义对应关联方法,将导致运行时异常,需确认每个中间模型均正确定义了 belongsTo、hasMany 等关系函数。
三、为预加载添加查询约束
在 with() 中传入闭包,可对关联模型的预加载查询施加 WHERE、ORDER BY 等条件,实现按需筛选,但需注意该闭包作用于整个关联结果集,不支持 per-parent 动态值(如不能使用 $post->id)。
1、限制只加载已发布的文章:User::with(['posts' => function ($query) { $query->where('published', true); }])->get()。
2、对评论按时间倒序排列,便于前端直接展示最新评论:Post::with(['comments' => function ($q) { $q->orderBy('created_at', 'desc'); }])->get()。
3、同时为多个关联分别设置条件:User::with(['posts' => fn($q) => $q->where('status', 'active')], ['profile' => fn($q) => $q->select('id', 'bio')])->get()。
四、避免常见陷阱:take/limit 在闭包中无效
在 with() 闭包中使用 take()、limit() 或 skip() 无法实现“每个父模型取 N 条子记录”的效果,因为 Eloquent 预加载底层采用的是单条 IN 查询,这些限制操作会被忽略或仅作用于整体结果集,失去数据库层优化意义。
1、以下写法不能保证每篇文章只取 3 条评论:Post::with(['comments' => function ($q) { $q->orderBy('created_at', 'desc')->take(3); }])->get()。
2、若需 Top-N 效果,必须改用数据库原生能力(如 MySQL 8.0+ 窗口函数)或手动构造关联子查询,Laravel 原生 with() 不支持此语义。
3、orderBy 在闭包中有效,可用于控制预加载结果的排列顺序,但数量控制须另寻方案。
五、结合 distinct() 确保多对多关联唯一性
在 belongsToMany 关系中,若中间表存在多条记录指向同一关联模型(如同一 Product 被不同 size 关联至同一 Collection),直接 with() 可能导致重复模型实例。此时需在预加载闭包中显式调用 distinct() 并配合 select 指定判重字段。
1、加载 Collection 及其指定 size 的 Product,并确保每个 Product 仅出现一次:Collection::with(['products' => function ($q) use ($sizes) { $q->whereIn('size', $sizes)->distinct()->select('products.*'); }])->get()。
2、distinct() 必须置于 select() 之前或与 select() 配合使用,否则可能因 SELECT * 导致判重失效。
3、该方式仅影响 products 关联的查询结果去重,不影响主模型 Collection 的查询逻辑。











