Laravel Eloquent的load()带回调未过滤关联结果问题如何解决

问题核心原因 #

该问题本质是Eloquent关联缓存被重复触发或已加载关联未被覆盖导致，常见触发场景有三个：

• 控制器调用->load()之前，已经通过$person->things访问过该关联，Eloquent已经将无过滤条件的所有关联结果缓存到了模型的relations属性中，后续调用->load()默认不会覆盖已经加载的关联
• Blade模板中误写为$person->things()（带括号调用关联方法），而非访问动态属性$person->things，这会直接发起新的无过滤查询
• 关联名称拼写错误，导致load加载的关联和实际访问的不是同一个

解决方案 #

按优先级尝试以下操作即可解决：

方案1：强制覆盖已加载的关联（最稳妥） #

调用load前先清空对应关联的缓存，避免历史缓存干扰：

public function some_method(Request $request, Person $person) {
    // 先清空已加载的关联
    $person->unsetRelation('things');
    $person->unsetRelation('other_things');

    $person->load([
       'things' => function ($query) {
          $query->where('status', 'active')
             ->whereDate('created_at', '<', '2021-01-01');
       },
       'other_things' => function ($query) {
          $query->where('status', 'active')
             ->where('color', 'red');
       }
    ]);

    return view('...', compact('person'));
}

方案2：手动查询关联后直接赋值 #

如果不确定关联是否被提前加载，可以直接执行自定义查询后写入模型关联属性，完全规避load的缓存逻辑：

$person->setRelation('things', 
    $person->things()
        ->where('status', 'active')
        ->whereDate('created_at', '<', '2021-01-01')
        ->get()
);
$person->setRelation('other_things',
    $person->other_things()
        ->where('status', 'active')
        ->where('color', 'red')
        ->get()
);

检查Blade模板写法 #

确认模板中访问关联时没有加括号，正确写法如下：

@foreach ($person->things as $thing)
{{ $thing->status == 'active' ? 'Active' : 'Inactive' }}
@endforeach

内容的提问来源于stack exchange，提问作者David