Laravel 8 POST请求下Flash Session闪存消息不生效问题排查

首先明确：success不是Laravel框架保留键名，正常读写不会有任何冲突。

你遇到的GET请求闪存正常、POST请求所有闪存（包括手动put的success键）失效、仅特定键的普通持久化会话可读取的问题，是Laravel Session配置错误的典型表现，按以下优先级排查即可解决：

1. 检查Kernel.php中间件配置（最高发诱因） #

绝大多数照着零散教程修改过中间件配置的开发者都会踩这个坑：
打开app/Http/Kernel.php，做两个核对：

• 绝对不要把\Illuminate\Session\Middleware\StartSession::class、\Illuminate\View\Middleware\ShareErrorsFromSession::class这两个Session相关中间件放到$middleware全局中间件数组里。
• 确认这两个中间件只存在于web中间件组中，默认正确的web中间件组配置如下：

protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        // \Illuminate\Session\Middleware\AuthenticateSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
        \Illuminate\Routing\Middleware\SubstituteBindings::class,
    ],
    // api等其他中间件组配置
];

重复挂载StartSession会导致Session被启动两次：第一次启动时写入的闪存数据，会在第二次启动Session时被标记为已消费直接清除。GET请求没有CSRF校验等额外流程，刚好不会触发重复启动的清除逻辑，所以表现为GET正常、POST全失效。

另外执行php artisan route:list确认：提交POST请求的路由、重定向目标的home路由，全部都挂载了web中间件组，没有漏挂。

2. 排查闪存数据被提前消费的问题 #

Flash闪存的生命周期是仅在设置后的下一个请求可读，读取后自动销毁，如果存在以下情况会导致数据提前消失：

• POST请求到重定向渲染视图之间存在多次跳转（比如重定向循环、自定义中间件触发的额外转发）
• 返回重定向前手动调用了session()->save()后又触发Session重启，或者有自定义逻辑调用了session()->pull()、session()->forget()处理闪存键
• 全局视图composer、前置中间件提前遍历读取了所有Session闪存数据，触发自动销毁

排查时直接在两个位置加临时调试代码：

1. POST控制器方法里，return Redirect之前加dd(session()->all())，看写入的flash、put的success键是否存在
2. 重定向目标的控制器方法或者视图最顶部加{{ dump(session()->all()) }}，看数据是否传到了下一个请求
   如果第一步能看到数据、第二步看不到，100%是中间件重复启动Session导致的数据被清除。

3. 排查特定键名读取失败问题 #

如果其他键的闪存恢复正常，只有success键读取失败，和闪存机制本身无关，直接检查：

• 有没有自定义服务提供者、全局中间件里写了针对success键的清理逻辑
• 视图层是否存在键名拼写错误
• CSRF校验失败的自定义响应逻辑里，是否重置了success键的Session数据

修复后清理缓存 #

调整完中间件配置后，执行以下命令清掉缓存的配置和路由，避免旧配置生效：

php artisan config:clear
php artisan route:clear
php artisan cache:clear

内容的提问来源于stack exchange，提问作者Eva Silviana