Laravel基于users与roles双表的认证：如何获取角色名称？

1. 先确保模型关联设置正确 #

User模型（app/Models/User.php） #

users表的role_id关联roles表的role_id主键，需要在User模型里明确指定关联的外键和父表主键：

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    // 保留默认的认证相关代码

    // 定义与Role模型的关联
    public function role()
    {
        // 参数依次为关联模型、当前表外键、关联表主键
        return $this->belongsTo(Role::class, 'role_id', 'role_id');
    }
}

Role模型（app/Models/Role.php） #

由于roles表的主键是role_id而非默认的id，需要手动指定主键，同时可添加反向关联（可选）：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Role extends Model
{
    // 指定表主键为role_id
    protected $primaryKey = 'role_id';

    // 反向关联User模型（可选）
    public function users()
    {
        return $this->hasMany(User::class, 'role_id', 'role_id');
    }
}

2. 认证后获取角色名称的几种方式 #

方式一：直接通过关联属性获取（懒加载） #

认证通过后，用Auth facade拿到当前用户，直接访问关联模型的name字段：

use Illuminate\Support\Facades\Auth;

public function yourBusinessMethod()
{
    if (Auth::check()) {
        $user = Auth::user();
        // 获取角色名称
        $roleName = $user->role->name;

        // 基于角色名称添加业务逻辑
        if ($roleName === 'admin') {
            // 管理员专属操作
        } elseif ($roleName === 'editor') {
            // 编辑专属操作
        }
    }
}

方式二：预加载关联（优化查询性能） #

如果需要处理批量用户数据，推荐预加载角色关联，避免N+1查询问题：

// 获取单个用户并预加载角色
$user = User::with('role')->find(Auth::id());
$roleName = $user->role->name;

// 批量获取用户时
$users = User::with('role')->get();
foreach ($users as $user) {
    echo $user->role->name;
}

方式三：直接DB查询（不推荐，尽量用ORM） #

如果不想依赖模型关联，也可以直接写查询语句获取：

use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\DB;

$roleName = DB::table('roles')
    ->where('role_id', Auth::user()->role_id)
    ->value('name');

常见问题排查 #

• 确认users表的role_id字段类型与roles表的role_id一致（比如均为int类型）
• 检查Role模型是否正确设置了$primaryKey = 'role_id'，否则会默认用id作为主键导致关联失败
• 避免空关联报错，可使用PHP 8+的可选链式调用：$user->role?->name，防止用户role_id无效时抛出错误

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