当修改 Laravel Breeze 的认证表名及字段（如将 email 改为 username、密码字段非 password）后，登录成功却跳回登录页，根源在于 LoginRequest::authenticate() 中 Auth::attempt() 传入的凭证键名未同步更新——必须严格匹配数据库字段名，而非请求输入名。
当修改 laravel breeze 的认证表名及字段（如将 email 改为 username、密码字段非 password）后，登录成功却跳回登录页，根源在于 `loginrequest::authenticate()` 中 `auth::attempt()` 传入的凭证键名未同步更新——必须严格匹配数据库字段名，而非请求输入名。
在 Laravel Breeze 中，Auth::attempt() 是认证流程的核心：它依据传入的键值对（如 ['email' => 'xxx', 'password' => 'yyy']）查询用户并验证密码。该数组的键名必须与数据库用户表中的实际列名完全一致；而默认的 $this->only('username', 'password') 仅按请求字段原样提取，若你的数据表中用户名字段名为 name、密码字段名为 user_pass，则直接传入 username 键会导致查询失败——即使 Auth::check() 在后续代码中返回 true（因 session 已被手动写入），但 redirect()->intended() 会因中间件 AuthenticateSession 或会话状态异常而重定向至登录页。
✅ 正确做法：显式映射请求字段到数据库列
打开 app/Http/Requests/Auth/LoginRequest.php，定位 authenticate() 方法。找到如下代码段：
if (! Auth::attempt($this->only('username', 'password'), $this->boolean('remember'))) {
RateLimiter::hit($this->throttleKey());
throw ValidationException::withMessages([
'email' => __('auth.failed'),
]);
}将其替换为显式键值映射（以常见自定义场景为例）：
// 假设数据库 users 表中：
// - 用户标识字段为 `name`（非 email）
// - 密码字段为 `user_pass`（非 password）
// - 登录表单提交字段仍为 `username` 和 `password`
$credentials = [
'name' => $this->input('username'), // ← 数据库列名: 'name'
'user_pass' => $this->input('password'), // ← 数据库列名: 'user_pass'
];
if (! Auth::attempt($credentials, $this->boolean('remember'))) {
RateLimiter::hit($this->throttleKey());
throw ValidationException::withMessages([
'username' => __('auth.failed'), // 注意：错误消息 key 应与表单字段名一致（即 blade 中的 name="username"）
]);
}? 关键原则：Auth::attempt() 的数组键 = 数据库字段名；值 = 从请求中提取的实际输入值。二者不可混淆。
⚠️ 同时需确认的配套配置
-
User 模型完整性
确保 App\Models\User 已正确声明：protected $table = 'your_custom_users_table'; // 自定义表名 protected $fillable = ['name', 'user_pass', /* 其他字段 */]; // 若密码字段非 'password'，必须重写 getAuthPassword() public function getAuthPassword() { return $this->user_pass; // 返回真实密码字段值 } 登录表单字段一致性
Blade 模板（如 resources/views/auth/login.blade.php）中输入框的 name 属性（如 name="username"）应与 $this->input('username') 中的键名保持一致，否则取不到值。错误提示字段名适配
如上例中 ValidationException::withMessages(['username' => ...])，其 key 必须与表单字段 name 匹配，才能让 @error('username') 正确渲染错误信息。
? 验证与调试建议
- 在 store() 方法中添加日志，确认凭证是否正确传递：
\Log::info('Auth credentials:', $credentials); - 使用 Tinker 手动测试 Auth::attempt()：
php artisan tinker >>> Auth::attempt(['name' => 'testuser', 'user_pass' => 'plain_password'])
（注意：此处 user_pass 是明文，仅用于调试；生产环境务必确保密码已哈希存储）
完成以上配置后，登录流程将准确命中数据库记录，Auth::check() 在重定向前为 true，且 redirect()->intended() 将正常跳转至首页，不再无故回落至登录页。
