Laravel redirect back调用with()方法无法存入Session问题

按以下优先级逐一排查，绝大多数同类问题都能定位解决：

• 校验路由中间件配置
  Laravel的Session能力由web中间件组提供，所有用到Session的路由必须在该中间件组覆盖范围内。打开app/Providers/RouteServiceProvider.php确认web路由默认绑定了web中间件，同时检查routes/web.php下的登录提交路由没有被移到api路由文件、或者手动排除了web中间件。
  如果你手动定义路由组，参考以下正确写法：

  Route::middleware('web')->group(function () {
      Route::post('/login-submit', [AuthController::class, 'login']);
  });
  

  注意：如果路由在api中间件组下，默认不会启动Session，with()传的闪存数据永远不会写入。
• 校验Session基础配置
  打开项目根目录的.env文件，修正以下配置项：

  # 本地开发优先用file驱动排查问题，不要一开始就用redis、database等驱动
  SESSION_DRIVER=file
  # 本地开发SESSION_DOMAIN留空，不要填线上域名、错误的端口号
  SESSION_DOMAIN=
  # 本地http环境下必须设为false，否则Cookie不会写入
  SESSION_SECURE_COOKIE=false
  

  修改配置后执行以下命令清除缓存，避免旧配置生效：

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

• 排查请求执行流程是否被中断
  back()->with()传递的是一次性闪存Session数据，必须等完整请求响应流程走完才会写入存储。如果你的控制器代码、前置/后置中间件里在return回跳逻辑之前有dd()、die()、exit()、提前return响应这类中断流程的操作，Session不会写入。
• 排查闪存数据生命周期问题
  闪存数据默认仅在下一个HTTP请求有效，如果回跳后触发了二次重定向（比如未登录用户被认证中间件拦截跳转、自定义公共逻辑触发二次跳转），闪存数据会在第二次请求时自动清除，最终渲染页面时就无法读取。可以临时用手动闪存的写法测试是否是生命周期问题：

  // 替换原有return back()->with()逻辑测试
  session()->flash('Sign-in-error', 'Log in failed!, username or password may be wrong please try again');
  return back();
  

  也可以直接用框架自带的错误消息传递方法withErrors()，该方法会自动处理闪存逻辑，兼容性更好：

  return back()->withErrors([
      'login' => 'Log in failed!, username or password may be wrong please try again'
  ]);
  

  前端对应读取方式：

  @if($errors->has('login'))
      <div class="alert alert-danger">{{ $errors->first('login') }}</div>
  @endif
  

• 校验目录写入权限
  如果使用file驱动，Web运行用户需要对storage、bootstrap/cache目录有写入权限，Linux环境执行以下命令修正权限：

  chmod -R 755 storage bootstrap/cache
  chown -R www-data:www-data storage bootstrap/cache
  

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