Laravel Eager Loading预加载关联失效问题排查

1. 检查关联方法的参数正确性 #

hasMany关联的参数规则必须严格对应：

• 第二个参数是**UserActivationCode表中指向EmployeeEmployment的外键字段**，默认是当前模型类名蛇形小写加_id（即employee_employment_id），你的场景需显式指定为employment_id。
• 第三个参数是**EmployeeEmployment的主键字段**，默认是id，如果你的主键不是id（比如是employment_id），必须显式声明。

错误示例（主键非默认id却未指定）：

public function test()
{
    return $this->hasMany(UserActivationCode::class, 'employment_id');
}

此时预加载会用模型默认的id字段值（可能为0）去关联，导致查询条件为employment_id in (0)。

正确示例（主键为employment_id时）：

public function test()
{
    return $this->hasMany(UserActivationCode::class, 'employment_id', 'employment_id');
}

2. 验证主模型的主键值 #

执行预加载后打印主模型的主键，确认是否为0：

$emp = EmployeeEmployment::with('test')->first();
dd($emp->id); // 若主键是自定义字段，改为$emp->employment_id

如果主键确实为0，说明主模型查询结果的主键本身就是0；但直接调用$emp->test能返回数据的话，要检查关联方法是否存在动态条件（比如根据模型属性修改查询逻辑），导致预加载和延迟加载的查询逻辑不一致。

3. 检查模型的主键定义 #

若EmployeeEmployment的主键不是默认的id，必须在模型中显式声明：

class EmployeeEmployment extends Model
{
    protected $primaryKey = 'employment_id';
    // ...
}

未设置的话，Laravel会默认用id作为主键，若数据库中该字段不存在或值为0，就会引发预加载条件异常。

4. 确认关联表的外键字段 #

检查user_activation_codes表是否存在employment_id字段，确认字段拼写（比如别写成employement_id）和数据类型与EmployeeEmployment的主键类型一致（比如同为int）。

5. 排查全局作用域或模型事件 #

如果EmployeeEmployment有全局作用域，或在boot方法中注册了模型事件，可能会修改模型主键值，导致预加载时使用错误的关联条件。可以临时注释全局作用域，重新测试预加载是否正常。

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