Laravel多角色登录故障：页面刷新与Auth guard未定义问题

1. 解决「Auth guard [user] is not defined」错误 #

这个问题是因为Laravel的认证配置中未定义user守卫，直接修改config/auth.php即可：

• 在guards数组中添加user守卫配置：

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],
    'admin' => [
        'driver' => 'session',
        'provider' => 'admins',
    ],
    'user' => [ // 新增user守卫
        'driver' => 'session',
        'provider' => 'users',
    ],
],

• 同时确认providers数组中存在对应的用户提供者：

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\Models\User::class,
    ],
    'admins' => [
        'driver' => 'eloquent',
        'model' => App\Models\Admin::class,
    ],
],

2. 修复管理员登录页面仅刷新的问题 #

检查登录控制器逻辑 #

确保控制器中针对管理员登录指定了正确的守卫，且验证失败时返回错误提示：

public function adminLogin(Request $request)
{
    $request->validate([
        'email' => 'required|email',
        'password' => 'required',
    ]);

    // 使用admin守卫验证登录信息
    if (Auth::guard('admin')->attempt([
        'email' => $request->email,
        'password' => $request->password
    ])) {
        return redirect()->intended('/admin/dashboard');
    }

    // 验证失败返回原页面并携带错误
    return back()->withErrors(['email' => '邮箱或密码不正确']);
}

确认Admin模型的认证特性 #

Admin模型必须继承Authenticatable并启用认证相关特性：

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;

class Admin extends Authenticatable
{
    protected $fillable = ['name', 'email', 'password'];
}

检查登录表单与路由匹配 #

• 确保管理员登录表单的action指向正确路由，且字段名与控制器验证一致：

<form method="POST" action="{{ route('admin.login') }}">
    @csrf
    <div>
        <label>邮箱</label>
        <input type="email" name="email" value="{{ old('email') }}" required>
        @error('email')
            <span>{{ $message }}</span>
        @enderror
    </div>
    <div>
        <label>密码</label>
        <input type="password" name="password" required>
    </div>
    <button type="submit">管理员登录</button>
</form>

• 确认路由配置正确关联控制器方法：

// 管理员登录路由
Route::get('/admin/login', [LoginAuthController::class, 'showAdminLoginForm'])->name('admin.login.form');
Route::post('/admin/login', [LoginAuthController::class, 'adminLogin'])->name('admin.login');

// 用户登录路由
Route::get('/login', [LoginAuthController::class, 'showUserLoginForm'])->name('user.login.form');
Route::post('/login', [LoginAuthController::class, 'userLogin'])->name('user.login');

验证密码哈希规则 #

确认管理员注册时密码是通过Laravel哈希方法加密的，避免明文存储：

// 管理员注册示例
Admin::create([
    'name' => $request->name,
    'email' => $request->email,
    'password' => Hash::make($request->password),
]);

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