Laravel Auth::attempt新创建用户登录验证失败问题求助

这类「老用户登录正常、仅新创建用户登录失败」的问题，根源都在近期改动的用户创建流程、表结构、模型相关逻辑上，按下面顺序排查可以快速定位：

• 优先排查密码存储逻辑：90%的同类问题都是新用户创建时没有用Hash::make()生成密码哈希，直接把明文密码/自定义加密规则生成的字符串存到了password字段。Auth::attempt验证时会自动调用Laravel默认Hash规则做校验，非Hash::make()生成的字符串100%校验失败。
  验证方式：取一条新创建用户的password字段值，临时运行Hash::check('该用户的测试明文密码', 取出的哈希值)，如果返回false，直接修改用户创建逻辑，保证密码入库前必须经过Hash::make($request->password)处理。
• 排查users表password字段长度：Laravel默认bcrypt/Argon2生成的哈希长度最少60位，如果后续修改表结构时把password字段设为varchar(60)以下的长度，存入时哈希值会被自动截断，直接导致校验失败。老用户是字段长度正常时存入的完整哈希所以不受影响，把字段修改为varchar(255)即可解决。
• 排查用户查询被拦截的情况：
  • 检查User模型是否加了全局作用域，比如软删除、账号状态校验（比如要求status=1才能正常查询），新用户默认状态值不符合要求就会被过滤，导致查询不到对应用户
  • 检查initials字段是否存在存储格式不匹配：比如存的时候带了前后空格、大小写和登录输入不一致，或者模型$casts配置对initials做了格式转换但入库时没做对应处理
  • 检查config/auth.php里默认guard对应的provider配置，确认关联的模型、表名是当前存储新用户的模型和表，避免出现新用户存到其他表、登录逻辑查旧表的情况
• 排查模型自定义逻辑：检查User模型是否重写了getAuthPassword()方法，如果重写过要确认返回的字段确实是存储密码哈希的password字段，不要出现返回其他无关字段的情况。

快速定位测试代码 #

把原有登录方法里的Auth::attempt逻辑临时替换成下面的代码，跑一次就能直接定位问题点，定位完成后删除即可：

public function login(Request $request)
{
  $request->validate([
    'initials'   => 'required|max:5',
    'password' => 'required'
  ]);

  // 临时调试代码
  $user = \App\Models\User::withoutGlobalScopes()
    ->where('initials', trim($request->initials))
    ->first();

  if (!$user) {
    dd('问题定位：查询不到对应用户，检查initials匹配度、表存储位置、全局作用域过滤规则');
  }

  if (!\Hash::check($request->password, $user->password)) {
    dd('问题定位：密码哈希校验失败，检查密码入库逻辑、password字段长度、getAuthPassword方法重写逻辑');
  }

  Auth::login($user, $request->remember);
  $request->session()->regenerate();
  return redirect()->route('scanner.index');
}

额外说明：如果近期修改过config/hashing.php里的哈希驱动、BCRYPT_ROUNDS参数，也可能导致新生成的哈希校验异常，但这类问题一般会伴随老用户也无法登录的情况，排查优先级放在最后即可。

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