Laravel 9中Session消息无法正常显示的问题求助

1. 确认路由是否绑定web中间件 #

Laravel的Session功能默认由web中间件提供支持，检查你的路由是否符合以下情况：

• 路由定义在routes/web.php文件中（该文件默认已绑定web中间件组）
• 若使用自定义路由分组，确保添加了web中间件：

  Route::middleware('web')->group(function () {
      // 你的路由
  });
  

如果路由在routes/api.php中，api中间件组默认不含Session支持，会导致闪存消息无法存储。

2. 替换Session门面为辅助函数 #

模板中使用Session门面可能因别名配置问题失效，改用session()辅助函数更可靠，修改模板代码为：

@if(session()->has('message'))
<div class="alert alert-warning alert-dismissible fade show" role="alert">
    {{ session('message') }}
    <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
</div>
@endif

3. 彻底清除所有缓存 #

执行以下命令确保缓存完全清除，避免旧配置或视图缓存影响：

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear
php artisan optimize:clear

4. 检查Session驱动与存储权限 #

• 查看.env文件的SESSION_DRIVER配置，若为file驱动，确认storage/framework/sessions目录有读写权限：

  chmod -R 755 storage/framework/sessions
  

• 若使用database驱动，确认Session表存在并正常，可重新生成：

  php artisan session:table
  php artisan migrate
  

5. 验证闪存消息是否写入Session #

在控制器中临时添加调试代码，确认消息是否被存入Session：

public function store(Request $request)
{
    $validated = $request->validate(['name' => ['required', 'min:3']]);
    Role::create($validated);

    session()->flash('message', 'Role created successfully.');
    // 打印所有Session数据，确认消息存在
    dd(session()->all());
    return back();
}

如果输出中包含message字段，说明Session写入正常，问题出在模板渲染；若不包含，说明Session存储环节异常。

6. 排查是否有代码清空Session #

检查自定义中间件、全局中间件或业务代码中，是否存在session()->flush()、session()->forget('message')等操作，导致闪存消息被提前清空。

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