登录成功却跳回 /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 编译。常见断点：
-
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') 并确保前后端域名完全一致。
