Laravel Eloquent子模型过滤错误：关联合同未按条件筛选

这个问题我之前也碰到过！核心原因是你只筛选了存在符合条件合同的客户，但没有对关联加载的合同列表做同样的约束，所以虽然客户选对了，但返回的还是该客户的全部合同。

正确的实现方式有两种： #

1. 结合 whereHas 和 with 的闭包约束（兼容所有Laravel版本）

whereHas 负责过滤出拥有符合条件合同的客户，而 with 的闭包则专门约束要加载的合同列表，只保留符合条件的项：

$customers = Customer::whereHas('contracts', function ($query) {
    $query->where('invoice_next', $this->invoice->next);
})->with(['contracts' => function ($query) {
    $query->where('invoice_next', $this->invoice->next);
}])->get();

2. 使用 withWhereHas 简化代码（Laravel 8.42+ 可用）

Laravel在8.42版本之后提供了 withWhereHas 方法，它相当于同时完成了「筛选客户」和「约束关联加载」两个操作，代码更简洁：

$customers = Customer::withWhereHas('contracts', function ($query) {
    $query->where('invoice_next', $this->invoice->next);
})->get();

为什么原来的写法不对？ #

如果你之前只写了 whereHas('contracts', ...)->with('contracts')，那么 with('contracts') 会默认加载该客户的全部合同，不会继承 whereHas 里的筛选条件——这两个是独立的查询逻辑，需要分别约束。

额外注意点 #

• 确保关联关系的名称 contracts 和你在 Customer 模型里定义的 hasMany 关联名称完全一致；
• 确认 $this->invoice->next 确实是你需要的筛选值，避免因变量为空或类型不匹配导致的无结果问题。

内容的提问来源于stack exchange，提问作者da.eXecutoR