Laravel 9 中使用 whereHas 实现关联模型字段的子查询过滤

在 laravel 9 中,无法直接通过 `$query->user->where(...)` 对关联模型字段进行条件筛选;正确方式是使用 `wherehas()` 方法,在关系约束闭包中定义子查询条件。
当你需要基于关联模型(如 User)的字段(例如 role)来过滤主模型(如 Monitor)时,不能在 where() 的闭包中调用 $query->user——因为此时 $query 是 Monitor 的 Eloquent Builder 实例,不支持直接访问关系属性(如 user),这会导致 Property [user] does not exist on the Eloquent builder instance 错误。
✅ 正确做法是使用 whereHas('user', ...):它会生成一条带 EXISTS 子查询的 SQL,精准匹配满足关联条件的 Monitor 记录。
/**
* 获取角色为 'customer' 的用户所关联的监控记录
*
* @return IlluminateDatabaseEloquentCollection
*/
protected function getInactiveUsersWithMonitors()
{
return Monitor::whereHas('user', function ($query) {
$query->where('role', 'customer');
})->with('user') // 可选:预加载关联数据,避免 N+1 查询
->get();
}
? 关键说明:
whereHas() 仅用于 过滤主模型(即只返回那些关联 User 满足条件的 Monitor),不自动加载关联数据;
若需同时获取 User 信息,请额外链式调用 ->with('user');
确保 Monitor 模型中已正确定义 user() 关系方法(如 belongsTo(User::class));
如需多条件或更复杂逻辑(如 role IN [...]、联合 orWhereHas),可在闭包内继续构建查询。给采集狗的一封信:技术YY网(技术YY网 www.jishuyy.com)的内容随便搬,链接记得留,不然你网站访客看到这句会更看不起你!
? 进阶提示:若还需排除活跃用户,可组合 whereDoesntHave() 或添加 where('active', false) 等主表条件。始终优先使用 whereHas 而非 with() + 手动过滤集合,以保障查询性能与数据库层面的准确性。

