Laravel 8 Passport认证中Auth::attempt()始终返回false问题求助

核心原因定位 #

Auth::attempt()返回false本质是用户凭证校验不通过，结合你给出的代码，常见原因和对应解决方法如下：

• 原因1：数据库存储的密码未加密
  Auth::attempt()会自动将传入的明文密码做哈希校验，若你注册用户时直接将明文密码存入数据库，必然校验失败。
  解决方法：注册逻辑中必须使用Hash::make()或bcrypt()加密密码后存储，示例：

// 注册方法中存储密码的逻辑
'password' => Hash::make($request->password)

• 原因2：config/auth.php配置错误
  Laravel 8默认将User模型放在App\Models目录下，且Passport需要将api guard的driver指定为passport，配置错误会导致找不到用户或认证驱动失效。
  解决方法：打开config/auth.php修改对应配置：

return [
    'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'users',
        ],
        'api' => [
            'driver' => 'passport',
            'provider' => 'users',
        ],
    ],
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\Models\User::class, // 确保路径和你实际User模型路径一致
        ],
    ],
];

• 原因3：请求参数键名不匹配
  你使用$request->only('email','password')获取参数，若前端传参的键名不是email、password（比如拼写为e-mail、pwd），会导致传入空值校验失败。
  解决方法：在login方法开头打印参数确认键值是否正确，示例：

public function login(Request $request){
    // 临时打印校验参数，确认无误后删除即可
    dd($request->only('email','password'));
    // 原有逻辑
}

• 原因4：Auth::attempt()依赖session guard的限制
  Auth::attempt()默认调用web guard，依赖session中间件，若你的登录路由放在api路由组下（默认无session中间件），会导致校验逻辑异常。
  解决方法：改用手动校验凭证的逻辑，同时兼容API场景的token生成：

use App\Models\User;
use Illuminate\Support\Facades\Hash;

public function login(Request $request){
    $user = User::where('email', $request->email)->first();
    // 先判断用户是否存在，再判断密码是否匹配
    if (!$user || !Hash::check($request->password, $user->password)) {
        return response([
            'message' => 'invalid user'
        ], 401);
    }
    // 校验通过后生成Passport token返回
    $token = $user->createToken('auth_token')->accessToken;
    return response([
        'user' => $user,
        'access_token' => $token
    ]);
}

其他排查方向 #

• 确认已执行php artisan passport:install完成Passport的初始化安装
• 确认数据库users表的password字段长度至少为60位，避免哈希值被截断导致校验失败
• 若你的User模型实现了MustVerifyEmail接口，未验证邮箱的用户会默认校验不通过，可在登录逻辑中增加邮箱是否验证的判断

内容的提问来源于stack exchange，提问作者Dr.Noob