远程一对多（hasonethrough/hasmanythrough）不支持wherehas，因其底层无法将闭包条件推至中间表或远端表，导致条件被忽略或报错；必须改用显式join或wheredoesnthave实现过滤。
远程一对多（HasOneThrough / HasManyThrough）不能直接用 whereHas，必须用 whereDoesntHave 或显式 join 才能加条件过滤。 因为 Eloquent 的远程关联底层不支持在闭包中写条件——它生成的 SQL 不会把条件下推到中间表或远端表，导致查询无效果或报错。
为什么 whereHas('relation') 在远程一对多上失效
远程关联（如 User → Post → Comment）依赖 HasManyThrough，它的查询逻辑是先查中间表（posts），再通过外键拉取远端表（comments）。但 whereHas 闭包只作用于最终目标模型（Comment），Eloquent 并不会自动将该闭包条件“翻译”进 JOIN 的 ON 子句或 WHERE 子句中；结果就是：条件被忽略，或触发全表扫描甚至 SQL 错误。
- 常见错误现象：
whereHas('comments', fn($q) => $q->where('status', 'approved'))返回所有用户，不管评论状态 - 根本原因：Eloquent 对
HasManyThrough的whereHas支持极弱，官方文档也明确标注“not supported” - 替代路径只有两条：手动
join，或改用whereDoesntHave（仅适用于“排除”类逻辑）
用 join 实现带条件的远程一对多查询
这是最可控、最通用的方式。以 User 查“发布过已审核评论的帖子”的用户为例（User → Post → Comment）：
$users = User::join('posts', 'users.id', '=', 'posts.user_id')
->join('comments', 'posts.id', '=', 'comments.post_id')
->where('comments.status', 'approved')
->where('comments.created_at', '>=', now()->subWeek())
->select('users.*')
->distinct() // 防止一个用户多条评论导致重复
->get();
- 必须加
distinct()：否则一个用户有 3 条匹配评论，就会返回 3 行相同用户 - 字段前缀不可省：如
'comments.status'，漏掉表名前缀会导致列名冲突或 SQL 报错 - 注意外键命名一致性：确保
posts.user_id和comments.post_id真实存在且类型匹配 - 索引建议：在
comments.post_id和comments.status上建联合索引，否则 JOIN 性能骤降
什么时候可以用 whereDoesntHave 替代
如果你要的是“排除型”逻辑（例如：找出所有 没有 被删除评论的用户），whereDoesntHave 是安全且语义清晰的选项：
$activeUsers = User::whereDoesntHave('comments', function ($q) {
$q->where('deleted_at', '!=', null);
})->get();
-
whereDoesntHave在远程关联上支持良好，Eloquent 会正确生成 NOT EXISTS 子查询 - 但它无法表达“存在且满足某条件”，只能表达“不存在满足某条件”，适用场景有限
- 不要试图在
whereDoesntHave里写where(...)->orWhere(...)，容易因括号优先级出错
别踩这个坑：别在模型里定义无效的远程作用域
有人会尝试在 User 模型里加一个局部作用域，比如：
public function scopeWithApprovedComments($query)
{
return $query->whereHas('comments', fn($q) => $q->where('status', 'approved'));
}
这看起来整洁，但实际无效——调用 User::withApprovedComments()->get() 仍不会过滤出任何东西。因为 whereHas 对 HasManyThrough 关系根本不生效。
- 真正可用的作用域必须基于
join或子查询，不能依赖关系方法名 - 如果业务中多次用到同类远程条件查询，建议封装成 Query Builder 类或 Repository 方法，而非模型作用域
- 测试时务必用
toSql()打印生成的 SQL，确认条件是否真的出现在 WHERE 子句里
远程一对多的条件过滤本质是 SQL 层问题，不是 ORM 语法糖能掩盖的。你得亲手控制 JOIN 和 WHERE，否则很容易拿到错数据还查不出原因。
