Laravel中Part关联Inv报错，如何通过双ID关联并支持预加载？

问题重现 #

在Part模型中定义了如下关联方法：

public function inv(): hasOne
{
    return $this->hasOne(Inv::class)->where([
      ['user_id', $this->user_id],
      ['survey_id', $this->survey_id]
    ]);
}

执行后报错：local.ERROR: SQLSTATE[42703]: Undefined column: 7 ERROR: column invs.part_id does not exist，已知Part和Inv均包含user_id、survey_id字段，且一对一对应，需要实现关联并支持->with('inv')预加载。

解决方案 #

修改Part模型中的关联方法，使用whereColumn关联两个模型的对应字段，覆盖Laravel默认的外键关联逻辑：

public function inv(): hasOne
{
    return $this->hasOne(Inv::class)
        ->whereColumn('invs.user_id', 'parts.user_id')
        ->whereColumn('invs.survey_id', 'parts.survey_id');
}

原因说明 #

1. 默认外键触发报错：Laravel的hasOne关联默认会自动生成invs.part_id = parts.id的关联条件，但你的表中不存在part_id字段，这是报错的直接原因。
2. 适配预加载场景：原代码用$this->user_id在单个模型调用时可以正常工作，但预加载是批量查询所有Part对应的Inv，此时$this指向固定模型实例，无法动态匹配每个Part的字段值。whereColumn会让Laravel在SQL层面生成表字段的关联条件，完美适配批量预加载的需求。

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