Laravel Eloquent HasMany/HasOne关联能否添加额外ON子句？

早上好！不用抱歉，这个问题其实很常见，而且完全不需要转回原生查询就能解决😉

你遇到的问题是因为 Eloquent 的 hasMany 关联默认是通过 WHERE 条件来关联模型，而不是 JOIN，所以直接调用 on() 方法肯定会报错——毕竟 Eloquent\Builder 确实没有这个方法，on() 是用于构建 JOIN 子句的 JoinClause 类的方法。

不过要实现多字段关联（同时匹配 Group 和 Reference），我们有更优雅的方式：

解决方案：使用 whereColumn() 定义关联 #

在你的 Vehicle 模型里，这样定义关联：

public function policy()
{
    return $this->hasMany(Policy::class)
        ->whereColumn('policies.Group', '=', $this->getTable() . '.Group')
        ->whereColumn('policies.Reference', '=', $this->getTable() . '.Reference');
}

解释一下：

• whereColumn() 用于比较两个数据库字段的值是否相等，正好符合你需要的多字段关联逻辑
• $this->getTable() 会动态获取当前 Vehicle 模型对应的表名，避免硬编码表名导致的维护问题
• 如果你的表名是固定的（比如 vehicles），也可以直接写死：->whereColumn('policies.Group', '=', 'vehicles.Group')

之后在控制器里预加载就完全正常了：

$vehicles = Vehicle::with('policy')->get();

生成的 SQL 会自动带上两个字段的关联条件：

1. 先查询所有车辆：SELECT * FROM vehicles;
2. 再批量查询对应的保单：SELECT * FROM policies WHERE Group IN (?, ?, ...) AND Reference IN (?, ?, ...);

进阶：自定义关联类（复杂场景） #

如果你的关联逻辑更复杂，或者需要复用这种多字段关联，可以自定义一个继承 HasMany 的关联类，重写关联查询的构建逻辑，但对于你的场景来说，上面的 whereColumn() 方案已经足够简单高效了。

所以完全不用退回到原生查询，用 Eloquent 就能完美解决你的问题！

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