Laravel hasMany关联返回null问题排查求助

我来帮你梳理几个最可能的遗漏点，都是日常处理Laravel关联问题时遇到的常见坑：

1. 补全关联方法的主键参数 #

Laravel默认会用父模型的id字段作为关联匹配键，但你的Module主键是自定义的slug，必须在关联方法里明确指定父模型的主键字段：

修改Module模型： #

class Module extends Model { 
    protected $primaryKey = 'slug'; 
    // 新增这两行，明确主键类型为字符串且非自增
    protected $keyType = 'string';
    public $incrementing = false;

    public function chapters() { 
        // 第三个参数指定父模型的关联主键为slug
        return $this->hasMany(Chapter::class, 'module_id', 'slug'); 
    } 
}

修改Chapter模型： #

class Chapter extends Model { 
    public function module() { 
        // 第三个参数指定父模型的主键字段为slug
        return $this->belongsTo(Module::class, 'module_id', 'slug'); 
    } 
}

2. 检查数据库字段类型匹配 #

确保modules表的slug字段和chapters表的module_id字段类型完全一致：

• 如果slug是varchar类字符串类型，module_id不能是int类型，必须同步为字符串类型
• 注意数据库排序规则（collation），比如utf8mb4_bin是区分大小写的，如果slug是"module-1"而module_id存的是"Module-1"，会直接匹配失败

3. 验证数据库数据的一致性 #

直接在数据库执行SQL查询，确认是否存在匹配的数据：

SELECT * FROM chapters WHERE module_id = '你的测试Module的slug值';

如果这条SQL没有返回结果，那就是数据本身不匹配，和代码逻辑无关。

4. 用预加载方式验证 #

有时候懒加载可能因为模型实例状态出现异常，可以试试预加载的方式查询：

$module = Module::with('chapters')->where('slug', '你的测试slug')->first();
dd($module->chapters);

如果预加载后能拿到数据，那可能是之前的$module实例没有正确触发懒加载，但这种情况比较少见。

内容的提问来源于stack exchange，提问作者R.Saif