Laravel嵌套关联预加载：如何让Contact匹配上级Research ID？

问题背景 #

• 模型关联规则：
  • Research 与 Location 为 BelongsToMany 关联
  • Location 与 Contact 为 BelongsToMany 关联
  • Contact 同时与 Research 关联
• 对应数据表：researches、locations、contacts，中间表 research_locations_list、location_contacts_list（后者包含 research_id 字段）
• 业务需求：
  • Research 1：仅在美国关联 Jack、John 联系人，英国无关联联系人
  • Research 2：英国关联 John，德国关联 Hanz
• 现存问题：使用预加载 Research::with('locations.contacts') 时，数据不符合预期（如 Research 1 的英国位置错误带出 John）；延迟加载可正常实现，但修改 getContactsAttribute 方法的实现方式不够优雅。

解决方案 #

核心思路是在预加载时，通过约束嵌套关联的查询条件，让每个 Location 下的 Contact 仅匹配当前关联的 Research ID，避免跨Research的联系人被错误加载。

方法：在Research模型中定义带约束的嵌套关联 #

在 Research 模型中新增一个关联方法，将 Location 和对应 Research 的联系人绑定在一起：

// Research 模型
public function locationsWithContacts()
{
    return $this->belongsToMany(Location::class, 'research_locations_list')
        ->with(['contacts' => function ($query) {
            // 约束联系人必须属于当前Research
            $query->wherePivot('research_id', $this->id);
        }]);
}

使用方式 #

查询时直接调用这个预定义的关联方法即可：

$researches = Research::with('locationsWithContacts')->get();

原理说明 #

这个方法在 Research 关联 Location 的同时，给 Location 的 Contacts 关联添加了额外约束：要求中间表 location_contacts_list 中的 research_id 等于当前 Research 的 ID。这样就能确保每个 Location 下加载的联系人，都是与当前 Research 绑定的，完全符合业务需求。

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