Laravel 5.4中使用AJAX设置Session无法持久化的问题

嘿，我之前也碰到过一模一样的情况——开发模式下一切正常，换个环境就掉链子，咱们一步步来排查解决：

1. 先查CSRF令牌是否正确携带 #

Laravel默认对所有POST请求做CSRF验证，artisan serve开发环境可能因为配置宽松没触发，但其他环境下如果请求没带令牌，不仅请求可能被悄悄拦截，还会导致Session上下文无法正确关联，设置的值自然留不住。

解决方法：

• 先在页面<head>里加个CSRF元标签：

  <meta name="csrf-token" content="{{ csrf_token() }}">
  

• 给AJAX请求补上令牌，两种方式选其一：
  • 全局配置jQuery的AJAX头（所有请求自动生效）：

    $.ajaxSetup({
        headers: {
            'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
        }
    });
    

  • 直接在当前POST请求的参数里带令牌：

    $.post('http://www.example.com/api/setSessionValue', { 
        "_token": "{{ csrf_token() }}",
        "data": data 
    })
    

2. 检查Session驱动与环境配置差异 #

开发模式和其他环境的Session配置可能不一样，这也是常见的坑：

• 打开.env文件，确认SESSION_DRIVER和相关配置：

  SESSION_DRIVER=file  # 开发环境常用file，其他环境如果用cookie/redis要确保配置正确
  SESSION_DOMAIN=www.example.com  # 和前端域名一致，跨域的话设为.example.com
  SESSION_PATH=/
  

• 检查storage/framework/sessions目录的读写权限，如果是Linux服务器，执行chmod -R 755 storage给目录开权限，不然Session文件写不进去，值肯定不持久。

3. 确认请求域名/跨域配置 #

你用了绝对地址http://www.example.com/api/setSessionValue，如果前端页面域名和这个不一致（比如前端是example.com，后端是www.example.com），就属于跨域请求，浏览器默认不会携带Session对应的Cookie，后端认不出同一个会话，设置的Session自然留不住。

解决方法：

• 尽量用相对路径发起请求，比如/api/setSessionValue，从根源避免域名不一致问题；
• 确实需要跨域的话，做两步配置：
  1. 前端AJAX开启凭证携带：

     $.ajax({
         url: 'http://www.example.com/api/setSessionValue',
         type: 'POST',
         data: { "data": data },
         xhrFields: {
             withCredentials: true
         },
         headers: {
             'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
         }
     });
     

  2. 后端Laravel配置CORS允许携带凭证，比如在自定义CORS中间件里加：

     return $next($request)
         ->header('Access-Control-Allow-Origin', 'http://你的前端域名.com')
         ->header('Access-Control-Allow-Credentials', 'true')
         ->header('Access-Control-Allow-Methods', 'POST, GET, OPTIONS')
         ->header('Access-Control-Allow-Headers', 'X-CSRF-TOKEN, Content-Type');
     

4. 排查是否存在请求重定向 #

有时候后端的路由、中间件（比如强制HTTPS跳转）会把POST请求重定向成GET请求，这时候第一次请求设置的Session会丢失，因为重定向后的会话上下文变了。可以打开浏览器开发者工具的网络面板，看看请求有没有3xx状态码的重定向，有的话调整对应路由或中间件逻辑。

先从CSRF令牌开始排查吧，这是最容易忽略也最常见的原因，应该能解决你的问题！

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