Laravel 10中HasManyThrough关联不遵循whereHas约束问题

问题背景 #

我在Laravel 10中构建HasManyThrough关联，涉及三个表：

• users表（标准Laravel字段）
• client_assignments表：记录用户与客户的分配关系，包含user_id和client_id字段
• media_ad_plans表：广告计划条目，属于单个客户，包含client_id字段

User模型中定义的关联如下：

public function adPlans(): HasManyThrough
{
    return $this->hasManyThrough(
        AdPlan::class,
        ClientAssignment::class,
        'user_id',
        'client_id',
        'id',
        'client_id'
    );
}

执行以下查询时，返回的用户会包含其所有广告计划项，而非仅符合whereHas条件的条目：

$users = User::with('adPlans.client')->whereHas('adPlans', function ($query) {
    return $query->duringTodayUsing('material_deadline', false); // 自定义作用域
})->get();

问题原因 #

whereHas的作用是筛选出拥有符合条件关联数据的主模型（User），但它不会限制with方法加载的关联数据范围。因此即使你用whereHas过滤了用户，with('adPlans')仍然会加载该用户的所有广告计划，而不是仅符合条件的那些。

解决方案 #

1. 使用withWhereHas（推荐，Laravel 8+支持） #

Laravel提供了withWhereHas方法，它会自动将whereHas的筛选条件应用到关联数据的加载中，同时完成用户筛选和关联数据过滤：

$users = User::withWhereHas('adPlans', function ($query) {
    $query->duringTodayUsing('material_deadline', false);
})->with('adPlans.client')->get();

或者可以将adPlans.client的加载合并到闭包中，避免重复调用：

$users = User::withWhereHas('adPlans', function ($query) {
    $query->duringTodayUsing('material_deadline', false)->with('client');
})->get();

2. 在with中手动添加筛选条件 #

如果你需要兼容更低版本的Laravel，或者需要更灵活的控制，可以在with的闭包中添加与whereHas完全相同的筛选条件：

$users = User::with(['adPlans' => function ($query) {
    $query->duringTodayUsing('material_deadline', false)->with('client');
}])->whereHas('adPlans', function ($query) {
    $query->duringTodayUsing('material_deadline', false);
})->get();

3. 验证关联定义正确性 #

虽然当前问题的核心不是关联定义，但仍需确保你的模型配置正确：

• 确认AdPlan模型指定了正确的表名：

  class AdPlan extends Model
  {
      protected $table = 'media_ad_plans';
      // 确保client关联正确
      public function client()
      {
          return $this->belongsTo(Client::class);
      }
  }
  

• 确认ClientAssignment模型指定了正确的表名：

  class ClientAssignment extends Model
  {
      protected $table = 'client_assignments';
  }
  

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