Laravel 8中Session闪存数据不生效问题求助

问题场景 #

使用Laravel 8开发项目，希望用户在login.blade.php输入错误登录凭证时显示错误提示。控制器代码如下：

if(Auth::attempt($credentials)){
    // 登录逻辑
}else{
    Session::flash('email', 'wrong credentials');
    return redirect()->back();
}

随后在Blade模板中添加检测代码：

@if(\Session::has('email'))
    @dd(1)
@endif

但@dd(1)未执行，通过@php dump(session()->all()); @endphp查看所有Session数据，结果返回[]，说明Session中的email数据未被正确存储。

以下是config/session.php配置内容：

<?php

use Illuminate\Support\Str;

return [

    /*
    |--------------------------------------------------------------------------
    | 默认Session驱动
    |--------------------------------------------------------------------------
    |
    | 该选项控制请求时使用的默认Session驱动，默认使用轻量级的file驱动，
    | 你也可以指定下面列出的其他驱动。
    |
    | 支持的驱动: "file", "cookie", "database", "apc",
    |            "memcached", "redis", "dynamodb", "array"
    |
    */

    'driver' => env('SESSION_DRIVER', 'file'),

    /*
    |--------------------------------------------------------------------------
    | Session生命周期
    |--------------------------------------------------------------------------
    |
    | 这里可以指定Session在闲置状态下的过期分钟数。如果希望浏览器关闭时立即过期，
    | 可以设置相应选项。
    |
    */

    'lifetime' => env('SESSION_LIFETIME', 120),

    'expire_on_close' => false,

    /*
    |--------------------------------------------------------------------------
    | Session加密
    |--------------------------------------------------------------------------
    |
    | 开启该选项后，所有Session数据会在存储前自动加密，你可以像平常一样使用Session，
    | Laravel会自动处理加密逻辑。
    |
    */

    'encrypt' => false,

    /*
    |--------------------------------------------------------------------------
    | Session文件存储路径
    |--------------------------------------------------------------------------
    |
    | 使用file驱动时，需要指定Session文件的存储路径。系统已经设置了默认路径，
    | 你也可以根据需要修改，该选项仅对file驱动生效。
    |
    */

    'files' => storage_path('framework/sessions'),

    /*
    |--------------------------------------------------------------------------
    | Session数据库连接
    |--------------------------------------------------------------------------
    |
    | 使用"database"或"redis"驱动时，可以指定用于管理Session的数据库连接，
    | 该连接需要与数据库配置文件中的连接项对应。
    |
    */

    'connection' => env('SESSION_CONNECTION', null),

    /*
    |--------------------------------------------------------------------------
    | Session数据库表
    |--------------------------------------------------------------------------
    |
    | 使用"database"驱动时，可以指定用于管理Session的数据表，系统提供了合理的默认值，
    | 你可以根据需要修改。
    |
    */

    'table' => 'sessions',

    /*
    |--------------------------------------------------------------------------
    | Session缓存存储
    |--------------------------------------------------------------------------
    |
    | 使用缓存类Session驱动时，可以指定用于存储Session的缓存存储，该值必须与应用配置的
    | 缓存"stores"项匹配。
    |
    | 影响的驱动: "apc", "dynamodb", "memcached", "redis"
    |
    */

    'store' => env('SESSION_STORE', null),

    /*
    |--------------------------------------------------------------------------
    | Session清理概率
    |--------------------------------------------------------------------------
    |
    | 部分Session驱动需要手动清理存储中的旧Session数据，这里设置每次请求时执行清理的概率，
    | 默认是100次请求中执行2次。
    |
    */

    'lottery' => [2, 100],

    /*
    |--------------------------------------------------------------------------
    | Session Cookie名称
    |--------------------------------------------------------------------------
    |
    | 这里可以修改用于标识Session实例ID的Cookie名称，框架每次创建新Session Cookie时都会使用该名称。
    |
    */

    'cookie' => env(
        'SESSION_COOKIE',
        Str::slug(env('APP_NAME', 'laravel'), '_').'_session'
    ),

    /*
    |--------------------------------------------------------------------------
    | Session Cookie路径
    |--------------------------------------------------------------------------
    |
    | Session Cookie路径决定了Cookie的可用范围，通常设为应用根路径，你也可以根据需要修改。
    |
    */

    'path' => '/',

    /*
    |--------------------------------------------------------------------------
    | Session Cookie域名
    |--------------------------------------------------------------------------
    |
    | 这里可以修改用于标识Session的Cookie域名，该设置决定了Cookie在哪些域名下可用，
    | 系统提供了合理的默认值。
    |
    */

    'domain' => env('SESSION_DOMAIN', null),

    /*
    |--------------------------------------------------------------------------
    | 仅HTTPS传输Cookie
    |--------------------------------------------------------------------------
    |
    | 将该选项设为true后，Session Cookie仅在HTTPS连接下才会发送回服务器，
    | 避免Cookie在不安全的连接中传输。
    |
    */

    'secure' => env('SESSION_SECURE_COOKIE'),

    /*
    |--------------------------------------------------------------------------
    | 仅HTTP访问Cookie
    |--------------------------------------------------------------------------
    |
    | 将该值设为true会阻止JavaScript访问Cookie值，Cookie仅能通过HTTP协议访问，
    | 你可以根据需要修改该选项。
    |
    */

    'http_only' => true,

    /*
    |--------------------------------------------------------------------------
    | Same-Site Cookie设置
    |--------------------------------------------------------------------------
    |
    | 该选项决定跨站请求时Cookie的行为，可用于缓解CSRF攻击。默认设为"lax"，这是安全的默认值。
    |
    | 支持的值: "lax", "strict", "none", null
    |
    */

    'same_site' => 'lax',

];

问题原因及解决方法 #

1. Session驱动配置错误 #

如果.env文件中SESSION_DRIVER设置为array，该驱动是内存临时存储，请求结束后数据就会销毁，导致重定向后的请求无法读取flash数据。
解决：修改.env中的SESSION_DRIVER为file或database等持久化驱动，比如：

SESSION_DRIVER=file

2. Session存储目录权限不足 #

使用file驱动时，storage/framework/sessions目录需要有读写权限，Laravel无法写入文件的话，Session数据无法保存。
解决：执行以下命令修复权限（根据服务器环境调整用户组）：

chmod -R 755 storage
chown -R www-data:www-data storage # 本地开发可替换为当前用户名，比如 chown -R yourname:yourname storage

3. Cookie配置与访问环境不匹配 #

如果SESSION_SECURE_COOKIE、SESSION_DOMAIN等配置和当前访问环境不一致，浏览器不会保存Session Cookie，导致后续请求无法读取Session。
解决：

• 本地HTTP访问时，确保.env中SESSION_SECURE_COOKIE=false；HTTPS环境设为true。
• SESSION_DOMAIN设置为当前访问域名，本地开发可留空或设为.localhost。

4. 更简便的替代方案 #

Laravel提供了专门的错误提示机制，无需手动操作Session，代码更简洁且不易出错：
控制器代码修改为：

if(Auth::attempt($credentials)){
    // 登录逻辑
}else{
    return redirect()->back()->withErrors(['email' => 'wrong credentials']);
}

模板中显示错误：
使用Laravel自带的@error指令：

@error('email')
    <div class="text-red-500">{{ $message }}</div>
@enderror

或者手动判断错误：

@if($errors->has('email'))
    <div class="text-red-500">{{ $errors->first('email') }}</div>
@endif

内容的提问来源于stack exchange，提问作者Pouya Vaghefi