Laravel教职工登录认证错误关联admins表的修复咨询

问题描述 #

测试教职工登录功能时，系统执行了错误的SQL查询，本该查询faculties表却查询了admins表：

SELECT
  *
FROM
  `admins`
WHERE
  `FacultyUsername` = Franco
limit
  1

核心问题排查 #

从提供的代码和配置中，定位出三个关键问题：

1. 默认认证Guard未切换到教职工角色 #

在config/auth.php中，默认Guard被设置为admins：

'defaults' => [
    'guard' => 'admins',
    'passwords' => 'admins',
],

调用Auth::attempt()时若未指定Guard，系统会自动使用默认的admins Guard，因此错误查询了admins表。

2. 登录凭证的密码字段拼写错误 #

在FacultiesController的facultyLogin方法中，获取凭证时写的是FacultyPasswword（多了一个w）：

$facultycredentials = $request->only('FacultyUsername','FacultyPasswword');

但表单提交的密码字段是FacultyPassword，这会导致密码字段无法正确获取，即使Guard配置正确，登录也会失败。

3. 教职工模型未指定自定义认证字段 #

Laravel默认使用email作为用户名字段、password作为密码字段，但你的faculties表使用的是FacultyUsername和FacultyPassword，若不在模型中明确指定，认证逻辑无法匹配自定义字段。

修复方案 #

按以下步骤逐一修复：

步骤1：登录时明确指定教职工Guard #

修改FacultiesController的facultyLogin方法，指定使用faculties Guard进行认证，同时修复密码字段拼写错误：

public function facultyLogin(Request $request){
    // 修复密码字段拼写错误
    $facultycredentials = $request->only('FacultyUsername','FacultyPassword');

    // 指定使用faculties Guard执行认证
    if (Auth::guard('faculties')->attempt($facultycredentials)) {
        return redirect()->intended('/facultydashboard');
    }
    return back()->withErrors(['msg' => '用户名或密码错误']);
}

步骤2：在教职工模型中定义认证字段 #

修改Faculties.php模型，添加自定义认证字段的配置：

class Faculties extends Model implements AuthenticatableContract
{
    use HasFactory, AuthenticatableTrait, HasRoles;

    protected $fillable = [
        'FacultyName',
        'FacultyDateofBirth',
        'FacultyAddress',
        'FacultyEmail',
        'FacultyUsername',
        'FacultyPassword',
    ];

    // 指定认证用的用户名字段
    protected $username = 'FacultyUsername';

    // 指定认证用的密码字段
    public function getAuthPassword()
    {
        return $this->FacultyPassword;
    }
}

步骤3：（可选）调整默认Guard（不推荐） #

如果教职工登录是系统主要场景，可以临时修改config/auth.php的默认Guard，但更推荐在代码中明确指定Guard，避免多角色认证混淆：

'defaults' => [
    'guard' => 'faculties',
    'passwords' => 'users', // 若需单独的教职工密码重置，需补充对应配置
],

修复验证 #

完成修改后重新测试登录功能，系统会正确执行查询faculties表的SQL：

SELECT * FROM `faculties` WHERE `FacultyUsername` = ? LIMIT 1

内容的提问来源于stack exchange，提问作者Franco Luis Rosel