wherehas用于筛选满足子表条件的父记录,只做存在性判断,语义清晰;需在闭包中写子表字段条件,不可链式调用多个wherehas,软删除需显式处理。

用 whereHas 筛父表,同时约束子表条件
当你只想拿到“满足子表某条件”的父记录(比如年份是2023且带标签ID=5的Post),whereHas 是最符合 Eloquent 风格的做法。它不加载子表数据,只做存在性判断,语义清晰、可读性强。
常见错误是把子表过滤条件写在主查询里,例如:Post::where('year', 2023)->where('tag_id', 5)->get() —— 这会报错,因为 tag_id 不在 posts 表中。
-
whereHas必须配合闭包,闭包里才能访问子模型的字段 - 多个子表条件要写在同一闭包内,不能链式调用多个
whereHas(否则变成“同时存在多个不同子记录”,不是同一子记录) - 如果子表有软删除,记得在闭包里加
->withTrashed()或->onlyTrashed(),否则查不到已软删的关联
示例:
$posts = Post::where('year', 2023)
->whereHas('PostTags', function ($q) {
$q->where('tag_id', 5);
})
->get();
用 join 同时查父子字段并过滤
当你需要在结果里直接拿到子表字段(比如显示每个 Post 对应的 tag_id),或者要基于子表字段排序、去重、分组时,join 是更直接的选择。它生成的是单层结果集,SQL 层面就完成拼接和筛选。
容易踩的坑是忘记给子表字段加别名或表前缀,导致字段冲突。比如 posts.id 和 posts_tags.id 都叫 id,直接 select * 会覆盖。
- 必须显式
select字段,避免用*;子表字段建议加别名,如posts_tags.tag_id AS tag_id -
join默认是INNER JOIN,没有子记录的父记录会被丢掉;需要保留所有父记录时,改用leftJoin - 如果子表有多条匹配记录,
join会导致父记录重复出现——这是预期行为,不是 bug
示例:
$posts = Post::select('posts.*', 'posts_tags.tag_id as tag_id')
->join('posts_tags', 'posts.id', '=', 'posts_tags.post_id')
->where('posts.year', 2023)
->where('posts_tags.tag_id', 5)
->get();
with 加闭包:既要结构化数据,又要过滤子表
当你要返回完整的父子结构(比如 API 返回一个 Post 及其全部匹配的 PostTag),但又不希望子表数据全量加载时,必须用带闭包的 with。它和 whereHas 是互补关系:whereHas 控制“选哪些父记录”,with 闭包控制“每个父记录加载哪些子记录”。
典型误操作是只写 with('PostTags'),结果把所有子记录都拉下来,再用 PHP filter() —— 这在大数据量下会严重拖慢响应。
-
with闭包里的where是对子表查询生效,不是对父表 - 如果子表关联本身是软删除,闭包里也要手动加
->withTrashed(),否则过滤失效 - 不要在
with闭包里用limit(),Laravel 不支持;想限制数量需换用load()+ 手动处理或改用原生 SQL
示例:
$posts = Post::where('year', 2023)
->whereHas('PostTags', function ($q) {
$q->where('tag_id', 5);
})
->with(['PostTags' => function ($q) {
$q->where('tag_id', 5);
}])
->get();
withCount 带条件时闭包必须写对
如果你只需要统计“每个父记录有多少个符合条件的子记录”,比如“每篇文章有几个已审核的评论”,那就用 withCount。但它的条件只能写在闭包里,写在外面完全无效。
最常被忽略的一点:闭包里的 where 作用域是子表,但字段名必须带表前缀(尤其跨库或字段名冲突时)。例如 comments.is_approved 不能简写成 is_approved。
-
withCount('PostTags')和withCount(['PostTags' => function ($q) { ... }])是两回事:前者统计全部,后者只统计闭包内条件匹配的数量 - MySQL 8.0+ 支持窗口函数,但
withCount生成的 SQL 仍走子查询,大数据量下注意索引覆盖 - 如果子表有联合唯一索引(如
(post_id, tag_id)),确保这个组合字段在where条件里被用到,否则可能全表扫描
示例:
$posts = Post::withCount(['PostTags' => function ($q) {
$q->where('tag_id', 5);
}])
->where('year', 2023)
->get();
// 结果每条 $post 都有 $post->post_tags_count 属性
复杂点在于:三种方式解决的问题维度不同——whereHas 是“选谁”,join 是“怎么拼”,with 闭包是“怎么装”。混用时顺序不能错:先用 whereHas 缩小父集,再用 with 闭包精筛子集,最后才考虑要不要 join 出平面数据。漏掉任一环节,要么查不到,要么查太多。











