You need to enable JavaScript to run this app. Laravel用Sanctum实现Vue Cookie认证时API端点鉴权失败问题
优惠活动
大模型
产品
解决方案
定价
更多

Laravel用Sanctum实现Vue Cookie认证时API端点鉴权失败问题

针对当前401问题的实操排查清单

从302循环重定向到现在返回401,已经解决了一半问题:之前的循环跳转本质是请求根本没携带登录Session,被当成未认证请求触发web端的认证重定向逻辑,又因为web端本身存在有效登录态,重定向到登录页后又跳回仪表盘。现在开启withCredentials后浏览器能正常携带Cookie了,还是返回401基本都是Sanctum的SPA认证配置存在遗漏,按以下顺序逐一核对即可:

  • 优先检查config/sanctum.php中的stateful配置数组,必须把当前本地访问项目的完整域名(含端口,比如localhost:8000、自定义本地域名project.test)完整加入数组。Sanctum只有识别到当前请求来自该列表内的受信任SPA,才会启用Cookie-based的Session鉴权逻辑;否则就算携带了Cookie,Sanctum也会默认走纯Token鉴权流程,直接抛出401错误。修改配置后一定要执行php artisan config:clear清除配置缓存,否则修改不会生效。
  • 核对跨域配置:config/cors.php中的supports_credentials必须设置为true,同时allowed_origins的取值要和上述受信任域名完全匹配,绝对不能使用*通配符——浏览器在跨域传递凭证时,会直接拦截通配符源的请求,就算后端配置允许也无法正常传递凭证。
  • 确认路由定义位置:测试接口必须定义在routes/api.php文件中,不要误放到web路由文件内;挂载auth:sanctum中间件时,不要在路由组内叠加会重置Session状态的自定义中间件,否则Session会被提前清空,无法识别登录态。
  • 验证前后端访问地址一致性:由于Inertia版Breeze的登录流程走的是web路由的Session认证,前端页面访问地址、API请求地址必须是同协议、同域名、同端口的,比如前端页面跑在http://localhost:8000,就不能把API请求发送到其他端口,否则Cookie会因为跨端口规则无法正常携带,后端自然读不到登录Session。
  • 补充本地开发常见踩坑:如果使用Laravel Valet、Herd这类工具运行自定义本地域名,需要核对.env中的SESSION_DOMAIN配置值,比如使用my-site.test作为访问域名时,就将该值设置为.my-site.test(前缀的点用于保证同级路径、子路径都能共享Cookie),不要使用默认的null值,否则Cookie作用域不匹配,后端无法正常读取登录会话。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.02 05:06:10