Vue项目配置多个代理服务器的多种方案

 更新时间:2025年07月15日 09:30:17   作者:江城开朗的豌豆  
今天咱们来聊聊Vue项目中一个非常实用的技巧 - 如何配置多个代理服务器,相信不少小伙伴在对接多个后端服务时都遇到过跨域问题,这篇文章就教你如何优雅解决,需要的朋友可以参考下

为什么需要多代理?

在实际开发中,我们经常会遇到这些情况:

  • 需要同时对接测试环境和生产环境API
  • 项目调用了多个不同域名的微服务
  • 某些特殊接口需要走特定代理

这时候,单一代理配置就捉襟见肘了。下面我就分享几种实用的多代理配置方案。

方案一:vue.config.js基础配置

这是最基础的代理配置方式,适合大多数场景。

// vue.config.js
module.exports = {
  devServer: {
    proxy: {
      '/api': {
        target: 'http://我的测试环境.com',
        changeOrigin: true,
        pathRewrite: {
          '^/api': ''
        }
      },
      '/other-api': {
        target: 'http://我的其他服务.com',
        changeOrigin: true,
        pathRewrite: {
          '^/other-api': ''
        }
      }
    }
  }
}

使用时代码中这样调用:

// 调用测试环境API
axios.get('/api/user/info')

// 调用其他服务API
axios.get('/other-api/product/list')

优点

  • 配置简单直观
  • 适合大多数项目
  • 不同路径对应不同服务

方案二:环境变量动态切换

如果需要根据环境动态切换代理目标,可以这样配置:

// vue.config.js
module.exports = {
  devServer: {
    proxy: {
      '/api': {
        target: process.env.VUE_APP_API_BASE,
        changeOrigin: true,
        pathRewrite: {
          '^/api': ''
        }
      }
    }
  }
}

然后在不同环境的.env文件中配置:

# .env.development
VUE_APP_API_BASE=http://我的开发环境.com

# .env.production
VUE_APP_API_BASE=http://我的生产环境.com

方案三:更灵活的多代理配置

对于复杂场景,可以这样组织代码:

// vue.config.js
const proxyTable = {
  dev: {
    '/api': {
      target: 'http://dev.我的服务.com',
      // 其他配置...
    },
    '/auth': {
      target: 'http://dev.我的认证服务.com',
      // 其他配置...
    }
  },
  test: {
    '/api': {
      target: 'http://test.我的服务.com',
      // 其他配置...
    }
    // 其他代理...
  }
}

module.exports = {
  devServer: {
    proxy: proxyTable[process.env.NODE_ENV] || proxyTable.dev
  }
}

实战案例:电商项目多服务代理

假设我们开发一个电商项目,需要对接:

  1. 用户服务 user-service
  2. 商品服务 product-service
  3. 订单服务 order-service

配置如下:

module.exports = {
  devServer: {
    proxy: {
      '/user': {
        target: 'http://user-service.我的公司.com',
        changeOrigin: true,
        pathRewrite: {'^/user': ''}
      },
      '/product': {
        target: 'http://product-service.我的公司.com',
        changeOrigin: true,
        pathRewrite: {'^/product': ''}
      },
      '/order': {
        target: 'http://order-service.我的公司.com',
        changeOrigin: true,
        ws: true,  // 如果需要WebSocket
        pathRewrite: {'^/order': ''}
      }
    }
  }
}

使用时:

// 获取用户信息
axios.get('/user/info')

// 获取商品列表
axios.get('/product/list')

// 提交订单
axios.post('/order/create', orderData)

常见问题解决方案

1. 代理不生效怎么办?

  • 检查target地址是否正确
  • 确认changeOrigin设置为true
  • 重启devServer

2. WebSocket代理失败?

proxy: {
  '/socket': {
    target: 'ws://我的websocket服务.com',
    ws: true,
    changeOrigin: true
  }
}

3. 需要携带Cookie怎么办?

proxy: {
  '/api': {
    target: 'http://我的服务.com',
    changeOrigin: true,
    cookieDomainRewrite: {
      "*": "localhost" // 把cookie域名重写为本地
    }
  }
}

配置建议

根据我6年的项目经验,建议:

  1. 代理路径前缀要语义化(如/api、/user等)
  2. 复杂项目建议按功能模块划分代理
  3. 生产环境记得移除或替换代理配置
  4. 使用环境变量管理不同环境的代理目标
  5. 定期检查代理配置,避免冗余

总结

通过合理配置多个代理,我们可以:

  • 轻松解决开发环境跨域问题
  • 同时对接多个后端服务
  • 实现环境间的无缝切换
  • 提高前端开发效率

写在最后​

以上就是Vue项目配置多个代理服务器的操作指南的详细内容,更多关于Vue项目多代理配置的资料请关注脚本之家其它相关文章!

相关文章

  • Vue3+Hooks实现4位随机数和60秒倒计时的示例代码

    Vue3+Hooks实现4位随机数和60秒倒计时的示例代码

    Vue3的Hooks是一种新的 API,本文主要介绍了Vue3+Hooks实现4位随机数和60秒倒计时的示例代码,具有一定的参考价值,感兴趣的可以了解一下
    2024-04-04
  • vue实现通讯录功能

    vue实现通讯录功能

    这篇文章主要为大家详细介绍了vue实现通讯录功能,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-07-07
  • undefined是否会变为null原理解析

    undefined是否会变为null原理解析

    这篇文章主要为大家介绍了undefined是否会变为null原理解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-02-02
  • Vue和React中快速使用Electron的简单教程

    Vue和React中快速使用Electron的简单教程

    Electron也可以快速地将你的网站打包成一个原生应用发布,下面这篇文章主要给大家介绍了关于Vue和React中快速使用Electron的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2022-05-05
  • Vue项目中平滑地引入HTML文件的五种方法实现与对比

    Vue项目中平滑地引入HTML文件的五种方法实现与对比

    这篇文章主要为大家详细介绍了Vue项目中平滑地引入HTML文件的五种方法实现与对比,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2025-10-10
  • vue的状态管理模式vuex

    vue的状态管理模式vuex

    本篇文章主要介绍了深入理解vue的状态管理模式vuex,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-11-11
  • vue.js循环radio的实例

    vue.js循环radio的实例

    今天小编就为大家分享一篇vue.js循环radio的实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-11-11
  • 实例讲解vue源码架构

    实例讲解vue源码架构

    在本篇文章中小编给大家分享了关于vue源码架构的相关知识点内容,有需要的朋友们学习下。
    2019-01-01
  • 深入理解Vue.js源码之事件机制

    深入理解Vue.js源码之事件机制

    本篇文章主要介绍了Vue.js源码之事件机制,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-09-09
  • vue.js开发环境搭建教程

    vue.js开发环境搭建教程

    这篇文章主要为大家详细介绍了vue.js开发环境的搭建教程,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-05-05

最新评论