Auth::attempt() 返回 false 的常见原因包括用户状态异常、守卫配置错误或字段映射不匹配；需确认密码为 bcrypt 加密、模型实现 Authenticatable、guards 和 providers 配置正确，以及自定义字段时重写对应方法。
Auth::attempt() 登录失败但没报错？检查凭证和守卫配置
Auth::attempt() 返回 false 时，Laravel 默认不抛异常，也不告诉你具体哪错了。常见原因不是密码错，而是用户状态、守卫（guard）或字段映射不匹配。
- 确保
users表里password字段是 bcrypt 加密的（用Hash::make()生成，别直接存明文或 md5） - 确认模型实现了
Illuminate\Contracts\Auth\Authenticatable（默认User已实现） - 检查
config/auth.php中'guards.web.provider'是否指向'users'，且'providers.users.model'指向正确模型类 - 如果改过登录字段（比如用
phone替代email），得在User模型里重写getAuthIdentifierName()和getAuthPassword()
Laravel 10+ 中 Auth::user() 返回 null？多半是中间件或会话问题
即使登录成功，后续请求中 Auth::user() 为 null，通常不是认证逻辑错，而是请求没走对中间件链或 session 未生效。
- 确保路由加了
auth中间件（如Route::get('/dashboard', ...)->middleware('auth')），而不是只靠auth:api这类守卫名 - Web 路由必须使用
web中间件组（它包含StartSession和ShareErrorsFromSession），否则 session 不持久 - 检查
APP_URL和SESSION_DOMAIN配置是否匹配当前访问域名（比如本地用http://localhost却配了.test） - 浏览器禁用 cookie 或启用了隐私模式也会导致 session ID 无法保存
忘记密码流程收不到邮件？先验证 MAIL_FROM_ADDRESS 和队列驱动
调用 Password::sendResetLink() 后无响应，或邮件根本没发出去，90% 是邮箱配置或队列卡住。
-
MAIL_FROM_ADDRESS必须是 SMTP 服务商允许发信的邮箱（比如用 Gmail，就得开“应用专用密码”，且不能用 2FA 直连） - 如果启用了队列（
QUEUE_CONNECTION=database或redis），记得运行php artisan queue:work，否则重置邮件永远不会发出 - 检查
config/auth.php中'passwords.users.email'是否指向正确的邮件视图（默认是emails.auth.password-reset），路径不存在会导致静默失败 - 开发环境建议先设
MAIL_MAILER=log，看日志里有没有生成的重置链接
自定义登录页后 419 页面过期？CSRF token 没传进表单
替换默认 login.blade.php 后提交表单报 419，不是 Laravel 故意拦你，是 CSRF 验证直接拒绝了无 token 的 POST 请求。
- 所有登录表单必须包含
@csrf（等价于<input type="hidden" name="_token" value="{{ csrf_token() }}">) - 如果用 Vue/React 等前端框架发请求，需从
meta[name="csrf-token"]取值并设到请求 header：X-CSRF-TOKEN - 别在表单外手动删掉
_token字段，也别用POST /login绕过 Laravel 的LoginController——它内部调用Auth::attempt()前会校验 token - 检查
VerifyCsrfToken中间件是否被意外移除或排除了/login
真正麻烦的不是写几行认证代码，而是每个环节都依赖上一个环节的配置正确性：session、cookie、guard、provider、密码哈希方式、CSRF、队列、邮件驱动……漏一个，就卡在“看起来该行，但就是不行”的地方。
