Laravel 8 基于Guard的多认证下管理员密码重置配置不生效问题

你之前为管理员专属密码重置控制器添加的自定义guard()、broker()方法，在Laravel 8的密码重置运行流程里根本不会被自动调用。
内置的密码重置控制器逻辑中，是直接通过Password门面做静态调用，默认读取config/auth.php里配置的全局默认密码broker（通常是关联users表的那个broker），完全不会识别你写在控制器内的自定义方法返回值，这也是为什么你提交管理员邮箱时，系统错误跑去查users表，最后抛出「找不到对应邮箱用户」报错的原因。

1. 直接在核心方法里指定密码broker，别等框架自动识别 #

很多人踩这个坑的原因就是以为写了broker()方法框架就会自动用，实际根本不会。你需要直接在两个管理员密码重置控制器的核心处理方法里，显式指定要用的admins broker：

• 管理员发送重置链接的PasswordResetLinkController@store方法，原来的默认代码是直接调用Password::sendResetLink，这个写法默认走全局配置的broker，要改成手动指定：

  // 原来的默认写法，走全局默认的users broker
  // $status = Password::sendResetLink($request->only('email'));
  
  // 改成手动指定admins broker，直接查admins表发重置链接
  $status = Password::broker('admins')->sendResetLink(
      $request->only('email')
  );
  

• 管理员提交新密码的NewPasswordController@reset方法，同样要把原来的默认Password::reset调用改成显式指定broker：

  // 原来的默认写法
  // $status = Password::reset($credentials, $resetCallback);
  
  // 改成用admins broker处理密码重置校验、更新逻辑
  $status = Password::broker('admins')->reset(
      $credentials,
      $resetCallback
  );
  

2. 手动指定重置完成后的登录guard #

密码重置成功后，框架默认会用web guard做自动登录，对应管理员场景需要手动指定admin guard：
在NewPasswordController的密码重置回调里，完成用户密码更新、保存的逻辑之后，加上指定guard的登录代码：

// 保存好新密码、记好token之后，用admin guard完成登录，别默认走web guard
auth()->guard('admin')->login($user);

3. 关于之前写的自定义guard()、broker()方法 #

这俩方法是Laravel Breeze脚手架生成的模板结构，但在Laravel 8的实际运行逻辑里，密码重置流程根本不会主动读取这两个方法的返回值，留着也只是没用的冗余代码，删掉完全不影响功能。

最后排查小提示：改完代码可以顺一遍config/auth.php里的passwords.admins配置，确认这个broker关联的用户提供者是指向admins表的查询逻辑，别配置错了关联到查users表的provider，不然就算代码写对了还是会查错表。

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