登录成功却跳回 /login 的根本原因是 Auth::attempt() 未查到用户，因凭证键名（如 'username'）与数据库字段名（如 'name'）不匹配导致静默失败，进而触发中间件重定向。

Auth::attempt()

默认只认 email 和 password 字段，改字段名或表结构后不手动映射就会静默失败——登录页刷一下又回来，控制台和日志里都不报错。

为什么登录成功却跳回 /login？

这不是跳转逻辑错了，而是 Auth::attempt() 根本没查到用户，但因为中间件或会话状态异常，它不报错、不提示，只默默重定向到登录页。常见诱因：

• LoginRequest::authenticate() 里用 $this->only('username', 'password') 直传字段，但数据库里用户名实际叫 name、密码字段是 user_pass
• User 模型没重写 getAuthPassword()，导致哈希比对用错字段
• 自定义表名后，$table 改了，但 Auth::attempt() 还在查默认的 users 表

如何让手机号/用户名字段正常登录？

不能只改表单 name 属性和数据库字段，关键三步必须同步：

• 在 User 模型里加 public function username() { return 'phone'; }（仅影响路由参数和部分中间件行为）
• 重写 getAuthPassword()：返回 $this->user_pass 或其他真实密码字段
• 修改 LoginRequest.php 中的 authenticate() 方法，显式构造凭证数组：

  if (! Auth::attempt([
      'phone' => $this->input('phone'),
      'password' => $this->input('password')
  ], $this->boolean('remember'))) { ... }

npm run dev 后页面样式全乱？

Tailwind CSS 不是“装完就生效”，Breeze 生成的 resources/css/app.css 必须被正确 import 并通过 Vite 编译。常见断点：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

• vite.config.js 里没把 resources/css/app.css 加进 build.rollupOptions.input
• app.blade.php 中引用的是 build/assets/app-xxx.css，但 npm run dev 输出路径不对，或用了 npm run build 却没清缓存
• 没运行 npm install 就直接 npm run dev，导致 tailwindcss、alpinejs 等依赖缺失

邮件验证点了链接却提示 “Invalid signature”？

不是链接过期，而是签名验证失败。核心原因只有两个：

• .env 里 APP_KEY 在生成验证 URL 后被重置过（比如重新 php artisan key:generate），旧链接立刻失效
• 用户点击链接时，当前请求的域名（如 http://localhost）与生成链接时的 APP_URL（如 https://myapp.test）不一致，Laravel 会拒绝验证

调试时可临时在 config/app.php 中设 'url' => env('APP_URL', 'http://localhost') 并确保前后端域名完全一致。