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
相关产品推荐
相关产品推荐

