Laravel调用$candidat->document->doc时报Attempt to read property "doc" on null错误

• 关联名称与定义不匹配：Candidat模型中定义的关联方法是documents()（复数，且为hasMany一对多关联），但视图中调用的是单数document，且hasMany返回的是集合对象，无法直接访问单个doc属性
• 外键配置不一致：Document模型中可填充字段定义的候选人外键是id_candidat，但belongsTo关联指定的外键是candidat_id，Candidat的关联也没有指定正确的自定义外键，导致关联查询找不到匹配数据返回null
• 未做空值兼容：部分候选人可能没有关联的文档数据，直接访问属性会触发null对象属性读取错误
• 控制器未使用预加载：直接全量查询会触发N+1性能问题，也可能加重关联查询异常概率

1. 修正模型关联配置 #

根据你的业务需求选择对应场景的修改方案：

场景A：1个候选人对应1份文档（一对一关联） #

修改Candidat模型关联：

// 替换原有的documents方法
public function document()
{
    // 第二个参数指定表中实际存储的自定义外键名
    return $this->hasOne(Document::class, 'id_candidat');
}

修改Document模型关联：

public function candidat()
{
    // 外键和表字段保持一致
    return $this->belongsTo(candidat::class, 'id_candidat');
}

场景B：1个候选人对应多份文档（一对多关联） #

保留Candidat模型的documents方法，补充外键配置：

public function documents()
{
    return $this->hasMany(Document::class, 'id_candidat');
}

同样修改Document模型的关联外键为id_candidat，和场景A配置一致。

2. 优化控制器查询，添加预加载 #

public function show()
{
    // 一对一关联用with('document')，一对多关联替换为with('documents')
    $candidat = candidat::with('document')->get();
    return view('candidat.liste', compact('candidat'));
}

3. 修正视图代码，添加空值兼容 #

一对一关联场景视图代码： #

@foreach($candidat as $key => $data)
    {{-- 使用null安全运算符，没有关联文档时不会报错 --}}
    {{ $data->document?->doc }}
    {{-- 旧版本Laravel可以用optional辅助函数：{{ optional($data->document)->doc }} --}}
@endforeach

一对多关联场景视图代码： #

需要循环遍历文档集合：

@foreach($candidat as $key => $data)
    @foreach($data->documents as $docItem)
        {{ $docItem->doc }}
    @endforeach
@endforeach

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