Laravel 8 调用addEagerConstraints()为空报错，动态关联加载失败如何解决

错误原因 #

报错是Laravel预加载机制和你写的动态关联逻辑冲突导致的：

• 调用load('entity')做懒预加载时，Laravel会先实例化一个空的User模型调用一次entity()方法，用来生成关联查询的SQL结构。此时空模型的$this->type没有赋值，switch判断没有命中任何分支，方法没有返回关联对象而是返回了null，框架尝试调用null的addEagerConstraints()方法就抛出了该错误。
• 哪怕你不用预加载，直接访问单个模型的$user->entity虽然能正常工作，但循环遍历用户列表时会产生N+1查询问题，性能很差。

解决方法 #

方案1：按用户类型分组预加载，搭配访问器实现统一调用 #

不需要修改现有表结构，改动最小：

1. 删除原来的entity()关联方法，新增两个独立关联和一个entity访问器：

// User模型中新增代码
public function getEntityAttribute()
{
    return $this->type === 'Client' ? $this->client : $this->provider;
}

public function client()
{
    return $this->hasOne(Client::class, 'id', 'client_id');
}

public function provider()
{
    return $this->hasOne(Provider::class, 'id', 'provider_id');
}

2. 查询时按类型分组分别预加载对应关联，避免N+1：

$users = User::with('person')->get();
// 分别给不同类型的用户预加载对应关联
$users->where('type', 'Client')->load('client');
$users->where('type', 'Provider')->load('provider');

// 后续可以统一用$user->entity访问对应关联数据
foreach ($users as $user) {
    var_dump($user->entity); // 自动返回对应Client/Provider实例
}

方案2：使用Laravel多态关联实现标准写法 #

如果后续可能新增更多用户类型，推荐用框架原生的多态关联，逻辑更清晰可扩展：

// User模型中定义自定义多态关联
public function entity()
{
    return $this->morphTo(
        __FUNCTION__,
        'type', // 类型字段名
        match($this->type) { // 不同类型对应的外键字段
            'Client' => 'client_id',
            'Provider' => 'provider_id',
            default => null
        }
    );
}

查询时直接预加载即可：

$users = User::with(['person', 'entity'])->get();
// 直接访问$user->entity即可拿到对应类型的实例

内容的提问来源于stack exchange，提问作者Nicolás Pistillo