You need to enable JavaScript to run this app. Chrome环境Laravel API Sanctum SPA认证跨子域CSRF token mismatch问题
优惠活动
大模型
产品
解决方案
定价
更多

Chrome环境Laravel API Sanctum SPA认证跨子域CSRF token mismatch问题

问题排查与解决步骤

1. 修复配置拼写错误

当前.env配置中的域名存在拼写错误,mydoamin.com 应为 mydomain.com,修正后配置如下:

SANCTUM_STATEFUL_DOMAINS=app.mydomain.com
SESSION_DOMAIN=.mydomain.com

修改完成后执行 php artisan config:clear 清除配置缓存生效。

2. 适配Chrome跨站Cookie规则(核心问题)

Chrome 80及以上版本对跨站Cookie有强制校验规则,要求跨场景使用的Cookie必须配置SameSite=None且开启Secure属性,火狐的校验策略相对宽松所以不会触发异常。
修改config/session.php配置:

// 生产环境必须开启,HTTP测试环境可临时设为false
'secure' => env('SESSION_SECURE_COOKIE', true),
// 跨子域名场景设置SameSite为None
'same_site' => 'none',

Laravel 8及以上版本需要同步修改config/sanctum.php中的Cookie配置,保持SameSite和Secure属性和session配置一致。

3. 补全CORS路径配置

如果你的登录接口路由不在api/前缀下,需要将对应路径补充到CORS配置的paths数组中:

'paths' => ['api/*', 'sanctum/csrf-cookie', 'login', 'login-user'],

4. 完善Axios配置

补充XSRF相关的默认配置,确保axios自动读取Cookie中的CSRF令牌并携带到请求头:

window.axios.defaults.withCredentials = true
window.axios.defaults.xsrfCookieName = 'XSRF-TOKEN'
window.axios.defaults.xsrfHeaderName = 'X-XSRF-TOKEN'

5. 验证效果

配置全部修改完成后按如下步骤验证:

  • 清除Chrome浏览器所有缓存和域名相关Cookie,重启浏览器
  • 打开Chrome开发者工具Application面板,查看XSRF-TOKEN和laravel_session两个Cookie的Domain为.mydomain.com,Secure属性为勾选状态,SameSite属性为None
  • 查看后续接口请求的Request Header,确认携带了X-XSRF-TOKEN请求头,且Cookie字段包含上述两个有效Cookie

如果使用Nginx作为Web服务器,需要确认没有额外的Cookie重写规则覆盖Laravel设置的SameSite和Secure属性。

内容的提问来源于stack exchange,提问作者lock

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 23:15:01