Laravel中courses关联关系返回null问题排查求助

1. 显式指定关联外键 #

你的Course表使用expert_id作为外键，但User模型的hasMany关联默认会推断使用user_id作为外键。虽然改名为products时正常，大概率是旧关联曾显式指定过外键，而新的courses关联遗漏了这一步。修改关联代码，明确指定外键：

public function courses()
{
    return $this->hasMany(Course::class, 'expert_id');
}

2. 排查User模型中的同名属性 #

如果User模型里定义了与关联名称同名的属性（比如public $courses;），会直接覆盖Eloquent的关联访问器，导致返回null。检查模型代码，移除或重命名这类冲突属性：

// 移除或重命名该属性，避免覆盖关联
// public $courses;

3. 清除Eloquent模型元数据缓存 #

除了你已执行的常规缓存命令，还需清理Laravel的模型元数据缓存：

php artisan model:clear

如果使用了第三方模型缓存工具，需同步清除对应缓存。

4. 检查Course模型的作用域限制 #

查看Course模型是否存在全局作用域，可能在查询courses关联时过滤掉了所有数据。比如：

// 检查是否存在类似全局作用域
protected static function booted()
{
    static::addGlobalScope('active', function ($query) {
        $query->where('active', 1);
    });
}

若存在这类作用域，可调整逻辑，或在关联中临时关闭：

public function courses()
{
    return $this->hasMany(Course::class, 'expert_id')->withoutGlobalScopes();
}

5. 验证关联生成的SQL语句 #

启用Laravel查询日志，查看实际执行的SQL，确认查询条件是否正确：

DB::enableQueryLog();
$expert->courses;
dd(DB::getQueryLog());

通过日志可确认是否使用了正确的expert_id外键，以及查询条件是否符合预期。

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