Laravel 8使用Guards实现管理员登录的问题排查

一、先解决登录报错问题 #

你遇到的错误核心是App\Models\Admin模型未实现Laravel认证所需的接口，导致Auth组件无法将其识别为可认证模型。

修改App\Models\Admin.php文件：

<?php

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;

class Admin extends Authenticatable
{
    // 若表名不是admins则需指定，否则可省略
    protected $table = 'admins';

    // 允许批量赋值的字段
    protected $fillable = [
        'email', 'password', 'is_admin',
    ];

    // 返回数据时隐藏敏感字段
    protected $hidden = [
        'password', 'remember_token',
    ];

    // 自动哈希密码（可选，也可手动在创建时处理）
    public function setPasswordAttribute($value)
    {
        $this->attributes['password'] = bcrypt($value);
    }
}

二、配置认证Guard与Provider #

打开config/auth.php文件，完成以下配置：

1. 添加admin Guard #

在guards数组中新增admin配置：

'guards' => [
    'web' => [
        'driver' => 'session',
        'provider' => 'users',
    ],

    // 新增管理员专属Guard
    'admin' => [
        'driver' => 'session',
        'provider' => 'admins',
    ],
],

2. 添加admins Provider #

在providers数组中新增对应Provider：

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

    // 关联Admin模型的Provider
    'admins' => [
        'driver' => 'eloquent',
        'model' => App\Models\Admin::class,
    ],
],

三、数据库记录规范 #

直接在数据库添加管理员记录时，密码必须存储哈希后的字符串，不能用明文。生成哈希密码的方式：

• 打开Laravel Tinker执行：echo Hash::make('你的管理员密码');，复制输出的哈希值存入数据库password字段。
• 或通过代码创建管理员：

Admin::create([
    'email' => 'admin@example.com',
    'password' => Hash::make('admin123'),
    'is_admin' => 1,
]);

四、首次登录的验证逻辑 #

首次登录管理员门户时，系统会使用你配置的admin Guard，验证admins表中匹配的邮箱与哈希密码，同时检查is_admin字段是否为1，全部满足则登录成功。

五、控制器代码优化（可选） #

你的AdminAuthController逻辑基本正确，可简化部分判断：

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

    if(auth()->guard('admin')->attempt($request->only('email', 'password'))){
        $user = auth()->guard('admin')->user();
        if($user->is_admin){
            return redirect()->route('adminDashboard')->with('success','登录成功');
        } 
        auth()->guard('admin')->logout();
        return back()->with('error','无管理员权限');
    }
    return back()->with('error','邮箱或密码错误');
}

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