Laravel中belongsTo()关联返回null的原因排查求助

我来帮你排查几个最可能导致$message->messageSender返回null的原因，一个个来验证：

1. 外键与关联模型主键不匹配 #

Laravel的belongsTo关联默认假设关联模型的主键是id，如果你的StudentData模型使用的不是默认的id作为主键（比如用了student_id），那你必须在关联方法里明确指定关联模型的主键字段：

public function messageSender() { 
    // 第三个参数是StudentData模型的主键字段
    return $this->belongsTo("App\StudentData", 'sender', 'student_id'); 
} 

先去检查student_datas表的主键是什么，再对应调整关联方法。

2. 没有预加载关联数据 #

你当前的查询只获取了Inbox的记录，没有预加载关联的StudentData数据，虽然Laravel支持懒加载，但有时候因为查询上下文或者模型配置问题，懒加载会失败。建议在控制器的查询里主动预加载关联：

$messages = $inbox->where('sender', $user_id) 
    ->where('trashed_in_sender', 0) 
    ->where('show_in_sender', 0) 
    ->orderBy('created_at', 'desc') 
    ->with('messageSender') // 加上这行预加载关联
    ->paginate($paginate); 

这样查询的时候会一次性把关联的StudentData数据拉取出来，避免懒加载可能出现的问题。

3. 数据库中没有匹配的关联数据 #

先确认inboxes表中这条记录的sender字段值，在student_datas表中是否存在对应的记录。比如你可以在视图里先打印{{ $message->sender }}，然后去student_datas表里查这个ID是否存在——如果数据库里本身就没有对应的学生数据，那关联自然返回null。

4. 模型命名空间或类名错误 #

检查App\StudentData这个类是否真的存在，有没有拼写错误？比如类名是不是写成了Studentdata（小写d），或者模型文件放在了子目录里（比如App\Models\StudentData），那关联里的命名空间就要改成对应的路径：

return $this->belongsTo("App\Models\StudentData", 'sender'); 

5. 表名与模型默认规则不匹配 #

Laravel默认模型对应的表名是复数形式，StudentData对应的表应该是student_datas，如果你的表名是单数（比如student_data），那需要在StudentData模型里手动指定表名：

class StudentData extends Model {
    protected $table = 'student_data';
    // ...其他代码
}

按上面的步骤逐一排查，应该就能找到问题所在啦。

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