Nuxt.js对接Laravel Sanctum时如何配置代理及理解核心参数?
代理核心参数直白解释
target:代理转发的最终目标服务地址。当你在浏览器端发起被代理规则匹配的请求时,Nuxt开发服务不会直接把请求交给浏览器跨域发送,而是在本地服务端层面把请求转发到这个target对应的地址。因为转发动作发生在服务端,完全不存在浏览器的CORS、同站点策略限制。pathRewrite:对匹配到代理规则的请求路径做自定义改写的规则。举个直观的流程例子:- 你在前端写的请求地址是
/api/user/profile - 没有pathRewrite的话,Nuxt会把这个请求原样转发到
target地址 + /api/user/profile - 如果你的Laravel后端实际的用户接口根本没有
/api这个前缀(实际路径是/user/profile),就可以通过pathRewrite把路径里的/api前缀替换成空,让Nuxt转发时实际请求的路径匹配后端的真实接口,避免404错误。
- 你在前端写的请求地址是
本地环境适配配置(Nuxt@3000 + Laravel@8000场景)
配置的核心逻辑是:所有对Laravel(包括Sanctum认证相关接口)的前端请求,都走和Nuxt前端同域的路径,由Nuxt的代理统一转发到8000端口的Laravel服务,彻底绕开跨域限制。
可直接套用的配置参考:
// nuxt.config.ts export default defineNuxtConfig({ // Nuxt 3 开发环境代理配置 devProxy: { // 匹配所有以 /api 开头的接口请求 '/api/': { target: 'http://localhost:8000', // 填写你本地Laravel服务的实际地址 changeOrigin: true, // *必须开启*:修改转发请求的Host头匹配后端域名,避免Sanctum拦截非法请求 pathRewrite: { '^/api/': '/' // 按你的实际接口路径调整,这里的作用是去掉请求里的/api前缀 } }, // 单独覆盖Sanctum认证相关的接口路径,避免cookie设置路径不对 '/sanctum/': { target: 'http://localhost:8000', changeOrigin: true, secure: false } }, // 搭配Auth模块的适配配置(与官方参考规则对齐) auth: { provider: { type: 'laravelSanctum', // *不要直接写Laravel的8000端口地址*,要写Nuxt本地同域的路径 baseURL: 'http://localhost:3000/api', } } })
配置落地注意事项
- 配置完成后不需要在Laravel端额外配置CORS跨域白名单,因为所有请求都是Nuxt开发服务在服务端转发,浏览器层面全程只和3000端口的Nuxt服务通信,根本不会触发跨域检测。
pathRewrite的规则要和你Laravel后端的实际接口路径完全匹配:比如如果你的Laravel接口本身就带/api前缀,就可以把pathRewrite配置删掉,Nuxt会原样把/api/xxx的路径转发到后端。- 一定要给所有代理规则加上
changeOrigin: true,否则Laravel端会因为请求来源头不匹配,把正常的代理请求当成跨站请求拦截。
内容的提问来源于stack exchange,提问作者Hamzeh
相关产品推荐
相关产品推荐

