You need to enable JavaScript to run this app. Nuxt.js对接Laravel Sanctum时如何配置代理及理解核心参数?
优惠活动
大模型
产品
解决方案
定价
更多

Nuxt.js对接Laravel Sanctum时如何配置代理及理解核心参数?

代理核心参数直白解释
  • target:代理转发的最终目标服务地址。当你在浏览器端发起被代理规则匹配的请求时,Nuxt开发服务不会直接把请求交给浏览器跨域发送,而是在本地服务端层面把请求转发到这个target对应的地址。因为转发动作发生在服务端,完全不存在浏览器的CORS、同站点策略限制。
  • pathRewrite:对匹配到代理规则的请求路径做自定义改写的规则。举个直观的流程例子:
    1. 你在前端写的请求地址是/api/user/profile
    2. 没有pathRewrite的话,Nuxt会把这个请求原样转发到target地址 + /api/user/profile
    3. 如果你的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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.28 21:54:03