Laravel 9 关联报错：尝试读取null的main_group_name属性

核心问题 #

你遇到的Attempt to read property "main_group_name" on null错误，本质是模型关联的字段匹配错误：

• Group模型的code_main_group字段存储的是MainGroup的code_main_group值，但定义belongsTo关联时，Laravel默认会尝试关联MainGroup的主键kode_barang，导致找不到对应数据，返回null。

分步解决 #

1. 修正模型关联定义 #

修改Group模型的mainGroup关联

public function mainGroup()
{
    // 第二个参数：当前模型的外键字段；第三个参数：主模型的关联字段（非主键）
    return $this->belongsTo(MainGroup::class, 'code_main_group', 'code_main_group');
}

修改MainGroup模型的group关联

public function group()
{
    // 第二个参数：子模型的外键字段；第三个参数：主模型的关联字段（非主键）
    return $this->hasMany(Group::class, 'code_main_group', 'code_main_group');
}

2. 修复迁移文件的外键类型与约束 #

foreignId()默认生成unsignedBigInteger类型，但MainGroup的code_main_group是integer，类型不匹配会导致外键约束失效，同时缺失外键约束也可能引发数据不一致：

修改Group迁移文件

Schema::create("mst_item_group", function(Blueprint $table){
    $table->integer('code_group')->primary();
    // 替换foreignId为integer，匹配MainGroup的字段类型
    $table->integer('code_main_group');
    $table->string('group_name');
    $table->timestampsTz();
    $table->string('created_user');
    $table->string('updated_user')->nullable();

    // 添加外键约束
    $table->foreign('code_main_group')
          ->references('code_main_group')
          ->on('mst_item_main_group')
          ->onDelete('restrict'); // 根据业务需求设置删除规则，比如cascade/restrict
});

3. 优化视图的空值处理 #

除了空合并运算符，Laravel提供optional()辅助函数更安全地处理关联为空的情况：

<p>Main Group : {{ optional($group->mainGroup)->main_group_name ?? $group->code_main_group }}</p>

4. 验证数据一致性 #

检查数据库中mst_item_group表的code_main_group值，确保在mst_item_main_group表的code_main_group字段中存在对应记录——如果数据本身不存在匹配项，关联自然会返回null。

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