Laravel 8 Sanctum Token API Vue Axios请求报CSRF token不匹配
你碰到的报错本质是混淆了Laravel Sanctum的两种独立认证模式:
Sanctum本身支持两类完全独立的认证逻辑:
- 适配SPA的Cookie会话认证:对指定的跨域前端域名自动开启CSRF token校验,靠Cookie维持登录状态
- 纯API的Bearer Token认证:靠客户端请求头携带的Token完成身份校验,本身不需要CSRF校验流程
你当前想实现的是第二种纯Token认证,结果因为配置问题,跨域发来的Vue请求被误判为SPA会话认证场景,触发了CSRF校验才会报token不匹配。Postman测试正常是因为Postman请求不触发浏览器跨域的Cookie携带规则,绕开了这个判断逻辑。
1. 先确认路由所属的分组
你定义的/login、/register两个接口,必须确保是写在routes/api.php文件中,而不是误写到routes/web.php里。
放在api.php中的路由会自动绑定api中间件组,默认是不开启CSRF校验的;如果误写到web.php里,所有POST请求都会强制走Laravel的Web CSRF校验流程,不管用什么客户端发请求都会报匹配失败。
注意:你现在写的控制器命名空间App\http\controller存在大小写和单复数问题,按照PSR-4规范正确的路径是App\Http\Controllers,路径写错哪怕路由正常加载,后续也会抛出类找不到的报错。
2. 调整Sanctum的状态域配置
打开项目根目录的.env配置文件,找到SANCTUM_STATEFUL_DOMAINS配置项:
- 纯Bearer Token认证模式下,直接把这个配置项的值清空即可。这个配置的作用是列出所有需要走Cookie会话+CSRF校验的前端域名,只要这里填入了你Vue应用的部署地址,跨域发来的POST请求就会被强制要求携带CSRF token,没带就会触发匹配失败报错。
3. 修正CORS跨域规则
打开config/cors.php配置文件,调整两项核心配置:
- 把你的API请求路径加到
paths数组中,确保跨域规则对这些路径生效,示例配置如下:
'paths' => ['api/*', 'login', 'register']
- 结合认证模式设置
supports_credentials参数:纯Bearer Token认证不需要跨域传递Cookie,把这个值设为false,就能从根源上避免请求触发Cookie会话相关的CSRF校验逻辑。
4. 排查前端Axios的配置问题
在Vue应用中发起请求时,注意两个容易触发报错的配置坑:
- 全局给Axios加上默认请求头
Accept: application/json,Laravel识别到这个请求头后,会强制把响应格式转为JSON,不会触发Web端的CSRF重定向逻辑。 - 纯Token认证场景下,不要全局开启Axios的
withCredentials: true配置,这个配置打开后跨域请求会自动携带目标域名的Cookie,直接触发Sanctum的状态域校验规则,没带CSRF头就会报错。
如果你的场景确实需要使用Cookie会话的SPA认证模式,需要在所有业务请求前先调用一次
/sanctum/csrf-cookie接口拉取CSRF cookie,再配合开启带凭证的请求配置,才能通过CSRF校验。
内容的提问来源于stack exchange,提问作者Lakshit

