Laravel with 方法使用详解

本文深入解析 Laravel Eloquent 中 with() 方法的正确用法与关键细节，帮你彻底告别 N+1 查询导致的性能瓶颈：从基础单关联、嵌套多层预加载，到带条件筛选的精准控制；同时明确指出 take/limit 在闭包中无效这一高频误区，并提供多对多关联去重的实战方案——无论你是刚接触 eager loading 的新手，还是正为复杂关联性能发愁的开发者，都能从中获得即学即用的优化策略。

如果您在 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 的查询逻辑。

今天关于《Laravel with 方法使用详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！