Laravel多守卫(guards)场景下管理员登录认证失败问题求助

你的代码共存在4处会直接导致认证失败的问题，按优先级逐一修复即可：

1. 控制器验证规则存在拼写/字段匹配错误 #

AdminLoginController中的验证规则存在两处低级错误：admin_email字段末尾多打了空格，密码字段名和表单提交的字段名不匹配，会导致验证逻辑异常。

// 错误原代码
$this->validate($request, [
    'admin_email ' => 'required|email', // 字段名末尾多余空格
    'password' => 'required|min:8' // 表单提交的密码字段是admin_password，不是password
]);

替换为以下代码：

$this->validate($request, [
    'admin_email' => 'required|email',
    'admin_password' => 'required|min:8'
]);

2. 密码字段不符合Laravel认证默认约定（核心失败原因） #

Laravel的Eloquent用户提供者默认会读取模型内的password字段做哈希校验，你使用自定义字段名admin_password时，直接传入attempt方法无法被自动识别，会导致密码哈希校验永远不通过。
两种修复方案选其一即可：

• 方案一（推荐，符合框架约定）：将admins表的密码字段改回默认的password，同步修改表单、控制器、模型内对应的字段名
• 方案二（保留自定义字段名）：首先在Admin模型中重写密码字段获取方法，告知框架自定义密码字段的位置：

// 在App\Models\Admin类中添加该方法
public function getAuthPassword()
{
    return $this->admin_password;
}

同时修正登录认证逻辑的传参，attempt方法的密码键名必须为password，映射请求中提交的密码值：

// 错误原代码
if( Auth::guard('admin')->attempt(['admin_email'=>$request->admin_email, 'admin_password'=>$request->admin_password], $request->remember))

// 修正后代码
if( Auth::guard('admin')->attempt(['admin_email'=>$request->admin_email, 'password'=>$request->admin_password], $request->remember))

注意：数据库中存储的管理员密码必须是通过Hash::make()生成的哈希值，明文密码永远无法通过框架认证校验。

3. 路由命名冲突导致跳转失效 #

你在admin路由分组中重复调用name()方法，会导致admin.dashboard路由名被覆盖，登录成功后跳转报错：

// 错误原代码
Route::get('/', [App\Http\Controllers\adminController::class, 'index'])->name('home')->name('admin.dashboard');

// 修正后代码，移除重复的home路由命名
Route::get('/', [App\Http\Controllers\adminController::class, 'index'])->name('admin.dashboard');

4. 后台路由缺少守卫中间件保护 #

当前后台首页路由没有绑定auth:admin中间件，就算登录成功，后续访问也无法正确识别已登录的管理员身份，建议调整路由分组结构：

Route::prefix('admin')->group(function (){
    // 游客可访问的登录相关路由
    Route::get('/login', [App\Http\Controllers\Auth\AdminLoginController::class, 'showLoginForm'])->name('admin.login');
    Route::post('/login', [App\Http\Controllers\Auth\AdminLoginController::class, 'login'])->name('admin.login.submit');
    
    // 登录后才可访问的后台路由，统一绑定admin守卫认证中间件
    Route::middleware('auth:admin')->group(function() {
        Route::get('/', [App\Http\Controllers\adminController::class, 'index'])->name('admin.dashboard');
        // 其余后台路由全部写在该分组内即可
    });
});

额外排查点 #

如果修复以上问题后仍然无法登录，检查两项配置：

• 确认admins表的admin_password字段长度至少为60位，否则密码哈希值存储不完整，会导致校验永远失败
• 执行php artisan config:clear和php artisan route:clear清除缓存，避免旧配置/旧路由缓存影响逻辑

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