Laravel用户认证失败及验证消息无法显示问题求助

一、验证错误消息不显示的修复 #

你的登录视图未添加错误消息展示逻辑，Laravel会将验证错误通过$errors共享变量传递到视图，需手动添加展示代码：

修改login视图，在表单内补充错误提示：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Login</title>
    <style>
        .error { color: #dc2626; margin-bottom: 8px; }
    </style>
</head>
<body>
    <h1>Login</h1>
    <form action="/login" method="post">
        @csrf
        <!-- 邮箱字段错误提示 -->
        @error('email')
            <div class="error">{{ $message }}</div>
        @enderror
        <input type="email" name="email" placeholder="Email" value="{{ old('email') }}">
        
        <!-- 密码字段错误提示 -->
        @error('password')
            <div class="error">{{ $message }}</div>
        @enderror
        <input type="password" name="password" placeholder="Password">
        
        <input type="submit" value="Login">
    </form>
</body>
</html>

这里用@error指令渲染对应字段的错误信息，同时通过old('email')保留用户之前输入的邮箱值，优化交互体验。

二、正确凭证无法登录的修复 #

1. 移除冗余的session手动存储代码
   auth()->attempt($credentials)方法已自动完成用户认证并将用户信息存入session，手动执行$request->session()->put('user', $user)会干扰默认认证会话逻辑，直接删除该行代码即可。

2. 确保用户密码已正确哈希
   如果用户是手动创建的（未使用Laravel自带注册逻辑），必须通过Hash::make()对密码进行哈希存储，否则attempt方法会验证失败：

// 示例：正确的用户创建代码
use Illuminate\Support\Facades\Hash;

$user = \App\Models\User::create([
    'name' => 'Test User',
    'email' => 'test@example.com',
    'password' => Hash::make('your-password'), // 必须哈希密码
]);

3. 为Home路由添加认证中间件
   确保/home路由仅允许已认证用户访问，避免登录后因路由权限问题出现异常：

Route::get('/home', [HomeController::class, 'index'])->name('home')->middleware('auth');

4. 完善ValidationException抛出逻辑
   抛出异常时指定重定向路径，确保错误消息正确回传到登录页面：

use Illuminate\Validation\ValidationException;

public function store(Request $request)
{
    $request->validate([
        'email' => 'required|email',
        'password' => 'required',
    ]);

    $credentials = $request->only('email', 'password');

    if (auth()->attempt($credentials)) {
        return redirect()->route('home');
    }

    throw ValidationException::withMessages([
        'email' => 'Invalid email or password.',
    ])->redirectTo(route('login'));
}

三、额外排查点 #

• 检查.env文件的SESSION_DRIVER配置，确保值为file或database（默认是file），若设置为array，会话数据无法持久化，会导致登录状态丢失。
• 执行缓存清理命令：php artisan cache:clear、php artisan config:clear，确保配置生效。

内容的提问来源于stack exchange，提问作者Fernando Vieira