Laravel 8 一对多关联中获取角色名称时出现Trying to get property 'name' of non-object错误的解决咨询

问题背景 #

我正在用Laravel 8开发项目，已经在User和Role模型间尝试建立一对多关联，且所有用户都已设置role_id，但在编辑用户页面获取角色名称时，抛出了Trying to get property 'name' of non-object错误。

相关代码如下：
User.php（模型关联）：

public function role() {
    return $this->belongsTo(User::class);
}

Role.php（模型关联）：

public function users() {
    return $this->hasMany(Role::class);
}

edit.blade.php（视图代码）：

<option selected="selected">{{ $user->role->name }}</option>

控制器edit方法：

public function edit(User $user) {
    return view('admin.users.edit', compact('user'));
}

附迁移代码：
roles表迁移：

public function up() {
    Schema::create('roles', function (Blueprint $table) {
        $table->id();
        $table->string('name');
        $table->string('slug');
        $table->timestamps();
    });
}

users表添加外键迁移：

public function up() {
    Schema::table('users', function (Blueprint $table) {
        $table->unsignedBigInteger('role_id')->nullable()->unsigned();
        $table->foreign('role_id')->references('id')->on('roles')->onDelete('cascade');
    });
}

问题根源 #

你的模型关联代码指向了错误的模型类，这是核心问题：

• User模型的role()方法里，belongsTo应该关联Role::class，而非User::class
• Role模型的users()方法里，hasMany应该关联User::class，而非Role::class

因为关联指向错误，Eloquent无法正确加载用户对应的角色数据，导致$user->role返回null，访问->name自然触发“获取非对象属性”的错误。

解决步骤 #

1. 修正模型关联代码

先修复两个模型的关联关系（如果外键字段符合Laravel规范，role_id可以省略第二个参数）：
User.php：

public function role() {
    return $this->belongsTo(Role::class, 'role_id');
}

Role.php：

public function users() {
    return $this->hasMany(User::class, 'role_id');
}

2. 预加载关联数据（优化+避免潜在问题）

为了避免N+1查询问题，同时确保关联数据被正确加载，建议在控制器的edit方法里预加载角色关联：

public function edit(User $user) {
    // 预加载role关联
    $user->load('role');
    // 也可以用路由模型绑定预加载（更优雅），或者User::with('role')->findOrFail($user->id);
    return view('admin.users.edit', compact('user'));
}

3. 视图层添加容错处理

即使修复了关联，为了避免极端情况（比如某条数据的role_id无效或被删除）导致页面崩溃，建议在视图中使用可选链操作符+默认值：

<option selected="selected">{{ $user->role?->name ?? '无角色' }}</option>

?->会在$user->role为null时停止访问，?? '无角色'则提供兜底显示值，提升页面健壮性。

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