HasManyThrough本质是“一对多→一对多”穿透查询，适用于中间模型含业务逻辑的场景（如Country→City→Post），非标准多对多；它只读、不支持sync/attach、无pivot字段、需严格对齐三参数且依赖数据库索引。
远程多对多（HasManyThrough）不是“多对多”，它本质是“一对多→一对多”的穿透查询，不能替代真正的 belongsToMany；用错场景会导致 N+1、数据错乱或查不到结果。
什么时候该用 HasManyThrough 而不是 belongsToMany
你真正需要的是“通过中间模型查到远端模型的多个实例”，且中间表本身有独立业务逻辑（比如带状态、时间、审批人等），而不是单纯关联桥梁。典型例子：一个 Country 有多个 City，每个 City 有多个 Post，你想直接从 Country 查所有 Post——这时才用 hasManyThrough。
常见误用：
- 想实现用户 ↔ 角色这种标准多对多，却写了
hasManyThrough—— 这会绕过中间表，根本查不到数据 - 中间模型（如
UserRole）没定义主键或缺少索引，导致through查询性能极差甚至超时 - 把
through模型当成普通模型去save()或监听事件，但它不触发 Eloquent 生命周期钩子
hasManyThrough 的三个参数必须严格对齐字段名
写法是：$this->hasManyThrough(RelatedModel::class, ThroughModel::class, 'first_key', 'second_key', 'local_key')。顺序和含义容易搞反，尤其第三、四、五个参数：
-
'first_key'：当前模型在ThroughModel表里的外键（如country_id） -
'second_key'：ThroughModel表里指向RelatedModel的外键（如city_id） -
'local_key'：当前模型自身的主键（默认id，但如果用uuid就必须显式传'uuid'）
例如：Country → City → Post：
public function posts()
{
return $this->hasManyThrough(
Post::class,
City::class,
'country_id', // City 表里存 Country 的外键
'city_id', // Post 表里存 City 的外键
'id' // Country 主键是 id
);
}
查出来的数据没有 pivot 字段，也不能用 sync() 或 attach()
hasManyThrough 是只读穿透查询，底层生成的是 JOIN SQL，不支持写操作。你不能用它来新增、删除或同步关联记录。
- 想给某个
Country批量添加Post？不行，得走City模型中转 - 想读中间表字段（比如
city_posts.created_at）？不能直接访问，得手动selectRaw或改用视图/原生查询 - 预加载要小心：
with('posts.author')可能触发错误 JOIN，建议拆成两层with(['cities.posts'])
容易被忽略的约束和陷阱
最常被跳过的其实是数据库层面的约束：
-
ThroughModel表必须有索引覆盖first_key和second_key，否则 JOIN 性能断崖下跌 - 如果
ThroughModel表用了复合主键（如[city_id, post_id]），Eloquent 不支持，会报错或返回空 -
hasManyThrough不支持withPivot()，也不识别中间模型的$casts或$appends - 当
RelatedModel本身还有软删除时，hasManyThrough默认不自动加where null条件，得手动whereNull('posts.deleted_at')
