Laravel Breeze登录时关联roles表获取角色数据的实现方案

你可以根据业务场景选择以下任意方案实现：

方法1：全局自动预加载（适合全场景都需要用到用户角色数据的情况） #

直接在User模型中设置$with属性，所有查询User模型的场景都会自动预加载关联的角色数据，登录场景也会自动生效：

1. 打开app/Models/User.php
2. 在类属性中添加以下代码：

// 若为单角色关联，关联名用role；多角色关联用roles
protected $with = ['role'];

设置完成后，任意位置通过auth()->user()获取的登录用户数据都会自带角色关联内容。

方法2：仅登录时加载（避免影响其他不需要角色数据的User查询） #

如果只有登录场景需要返回角色数据，不需要全局预加载，可以直接修改Breeze的登录逻辑：

Web端Session认证场景 #

修改app/Http/Requests/Auth/LoginRequest.php中的authenticate方法，登录验证通过后手动加载关联：

public function authenticate()
{
    $this->ensureIsNotRateLimited();

    if (! Auth::attempt($this->only('email', 'password'), $this->boolean('remember'))) {
        RateLimiter::hit($this->throttleKey());

        throw ValidationException::withMessages([
            'email' => trans('auth.failed'),
        ]);
    }

    // 登录成功后手动加载角色关联
    Auth::user()->load('role');

    RateLimiter::clear($this->throttleKey());
}

API端Sanctum认证场景 #

修改登录接口的处理逻辑，返回用户数据前加载关联：

public function store(LoginRequest $request)
{
    $request->authenticate();

    $user = $request->user();
    // 预加载角色关联
    $user->load('role');

    return response()->json([
        'user' => $user,
        'token' => $user->createToken('auth_token')->plainTextToken,
    ]);
}

注意事项 #

首先确认User模型的关联定义符合你的业务逻辑：

• 如果是单角色场景（user表带有role_id外键），关联应为一对一belongsTo：

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

• 如果是多角色场景（用户-角色中间表），关联应为多对多belongsToMany，此时关联名用roles，加载时也对应使用load('roles')。

配置完成后，登录后即可通过auth()->user()->role->role_name直接获取到角色名称，如示例中的Wholesaler。

内容的提问来源于stack exchange，提问作者poojan mehta PM