Vue解决开发环境Ajax跨域问题的多种方法对比

 更新时间:2025年11月03日 09:56:17   作者:咖啡の猫  
本文将带大家深入理解跨域原理,并提供 Vue CLI(webpack)和 Vite 两种构建工具下的完整解决方案,让大家的开发流程更顺畅,希望对大家有所帮助

一、前言

在 Vue 项目开发中,我们经常会遇到这样的报错:

Access to XMLHttpRequest at 'http://api.example.com/login' 
from origin 'http://localhost:8080' has been blocked by CORS policy: 
No 'Access-Control-Allow-Origin' header is present on the requested resource.

这就是典型的 跨域请求被浏览器拦截。

虽然生产环境中通常由后端配置 CORS 或 Nginx 反向代理解决,但在本地开发阶段,前后端往往独立运行(前端 localhost:8080,后端 localhost:3000),如何优雅地绕过跨域限制?

本文将带你深入理解跨域原理,并提供 Vue CLI(webpack)和 Vite 两种构建工具下的完整解决方案,让你的开发流程更顺畅。

二、什么是跨域?为什么会出现?

同源策略(Same-Origin Policy)

浏览器出于安全考虑,实施了“同源策略”:只有 协议(protocol)、域名(host)、端口(port) 完全相同,才允许访问彼此的资源。

当前页面请求地址是否跨域原因
http://localhost:8080http://localhost:8080/api❌ 不跨域同协议、同域名、同端口
http://localhost:8080http://localhost:3000/api✅ 跨域端口不同
http://localhost:8080https://localhost:8080/api✅ 跨域协议不同
http://localhost:8080http://api.dev.com:8080✅ 跨域域名不同

浏览器会阻止 JavaScript 发起跨域请求,除非服务端明确允许(CORS)。

三、开发环境 vs 生产环境的区别

环境特点跨域解决方案
开发环境前后端分离,本地启动使用 开发服务器代理(Proxy)
生产环境部署在同一域名下通过 Nginx 反向代理或后端开启 CORS

重点:本文聚焦 开发环境 的跨域解决!

四、解决方案 1:Vue CLI / webpack-dev-server 代理(推荐)

如果你使用的是 Vue CLI 创建的项目(基于 webpack),可以通过配置 vue.config.js 实现请求代理。

1. 创建vue.config.js

在项目根目录创建文件 vue.config.js:

// vue.config.js
const { defineConfig } = require('@vue/cli-service')

module.exports = defineConfig({
  devServer: {
    proxy: {
      '/api': {
        target: 'http://localhost:3000', // 后端服务地址
        changeOrigin: true,               // 修改请求头中的 origin
        secure: false,                    // 支持 https 目标
        pathRewrite: {
          '^/api': ''                     // 重写路径,去掉 /api 前缀
        }
      }
    }
  }
})

2. 前端代码中发起请求

// 原本请求:http://localhost:3000/user/login
// 现在只需请求:/api/user/login

axios.post('/api/user/login', { username, password })
  .then(res => console.log(res.data))

3. 工作原理图解

前端代码 → http://localhost:8080
           ↓ (浏览器)
axios.post('/api/user/login')
           ↓
Vue DevServer 拦截以 /api 开头的请求
           ↓
转发到真实后端 → http://localhost:3000/user/login
           ↓
返回响应 → 再由 DevServer 返回给前端

优点:

  • 前端无需关心真实后端地址
  • 完美绕过浏览器跨域限制
  • 配置简单,一行代码搞定

五、解决方案 2:Vite 项目代理(适用于 Vue 3 + Vite)

如果你使用的是 Vite 构建的 Vue 项目(如 create-vue 或 vite create),配置方式略有不同。

1. 修改vite.config.js

// vite.config.js
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
  server: {
    proxy: {
      '/api': {
        target: 'http://localhost:3000',
        changeOrigin: true,
        rewrite: (path) => path.replace(/^\/api/, '') // Vite 中用 rewrite
      }
    }
  }
})

注意:Vite 中使用 rewrite 而不是 pathRewrite。

2. 前端请求方式不变

axios.get('/api/users') // 自动代理到 http://localhost:3000/users

六、进阶配置:多接口前缀代理

如果项目需要对接多个后端服务,可以配置多个代理规则:

// vue.config.js 或 vite.config.js
proxy: {
  '/api': {
    target: 'http://localhost:3000',
    changeOrigin: true,
    pathRewrite: { '^/api': '' }
  },
  '/upload': {
    target: 'http://upload.service.com',
    changeOrigin: true
  },
  '/mock': {
    target: 'https://mockapi.com',
    changeOrigin: true,
    secure: false
  }
}

示例:

  • /api/users → http://localhost:3000/users
  • /upload/file → http://upload.service.com/file
  • /mock/data → https://mockapi.com/mock/data

七、其他方案对比(不推荐用于开发)

方案是否推荐说明
JSONP❌仅支持 GET,已被时代淘汰
CORS 后端配置⚠️ 有条件需后端配合,开发期可能无法修改
浏览器禁用安全策略❌危险操作,影响系统安全
自己起一个中间 Node 服务⚠️ 复杂小题大做,不如用代理

结论:开发服务器代理是最佳选择!

八、常见问题与解决方案

问题 1:代理后接口 404?

原因:pathRewrite 配置错误,路径未正确转发。

解决:

  • 检查 target 地址是否可达
  • 打开浏览器 Network,查看实际请求 URL
  • 确保 changeOrigin: true

问题 2:WebSocket 也能代理吗?

可以!Vite 和 webpack 都支持 WebSocket 代理:

proxy: {
  '/ws': {
    target: 'ws://localhost:8080',
    ws: true,
    changeOrigin: true
  }
}

问题 3:代理后 Cookie/Sessions 丢失?

原因:跨域时 Cookie 默认不携带。

解决:

前端请求设置 withCredentials: true

axios.defaults.withCredentials = true

后端响应头需允许:

Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: http://localhost:8080  # 不能为 *

九、生产环境部署建议

开发期用代理,上线后怎么办?

推荐方案:Nginx 反向代理

server {
    listen 80;
    server_name yourdomain.com;

    # 前端静态资源
    location / {
        root /usr/share/nginx/html;
        try_files $uri $uri/ /index.html;
    }

    # API 代理到后端
    location /api/ {
        proxy_pass http://backend-server:3000/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

这样前后端共用同一域名,彻底解决跨域问题。

十、总结

工具配置文件核心配置
Vue CLI (webpack)vue.config.jsdevServer.proxy
Vitevite.config.jsserver.proxy
生产环境Nginxlocation + proxy_pass

开发环境跨域三步走:

  • 确定后端接口地址(如 http://localhost:3000)
  • 在 vue.config.js 或 vite.config.js 中配置代理
  • 前端请求统一加前缀(如 /api)

到此这篇关于Vue解决开发环境Ajax跨域问题的多种方法对比的文章就介绍到这了,更多相关Vue解决Ajax跨域问题内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 在Vue中延迟执行某个函数的实现方式

    在Vue中延迟执行某个函数的实现方式

    在Vue中延迟执行某个函数,你可以使用setTimeout()函数或者Vue提供的生命周期钩子函数,本文通过一些示例代码给大家介绍的非常详细,对大家的学习或工作有一定的帮助,需要的朋友可以参考下
    2023-12-12
  • vue-cli2.x项目优化之引入本地静态库文件的方法

    vue-cli2.x项目优化之引入本地静态库文件的方法

    这篇文章主要介绍了vue-cli2.x项目优化之引入本地静态库文件的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-06-06
  • Vue组件之间数据共享浅析

    Vue组件之间数据共享浅析

    本文章向大家介绍vue组件中的数据共享,主要包括vue组件中的数据共享使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下
    2022-11-11
  • 从0到1搭建element后台框架优化篇(打包优化)

    从0到1搭建element后台框架优化篇(打包优化)

    这篇文章主要介绍了从0到1搭建element后台框架优化篇(打包优化),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-05-05
  • vue中定义全局声明vscode插件提示找不到问题解决

    vue中定义全局声明vscode插件提示找不到问题解决

    这篇文章主要为大家介绍了vue中定义全局声明vscode插件提示找不到问题解决,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-05-05
  • Vue3使用md-editor-v3的实例解读markdown文本

    Vue3使用md-editor-v3的实例解读markdown文本

    本文介绍了如何在Vue3项目中使用md-editor-v3实现Markdown编辑器,包括基础实现、工具栏自定义、预览功能以及扩展功能
    2026-01-01
  • vue.js实现简单轮播图效果

    vue.js实现简单轮播图效果

    这篇文章主要为大家详细介绍了vue.js实现简单轮播图效果的相关代码,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-10-10
  • Vue对象的单层劫持图文详细讲解

    Vue对象的单层劫持图文详细讲解

    这篇文章主要介绍了vue2.x对象单层劫持的原理实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-01-01
  • ElementUI修改实现更好用图片上传预览组件

    ElementUI修改实现更好用图片上传预览组件

    这篇文章主要为大家介绍了ElementUI修改实现更好用图片上传预览组件示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-09-09
  • js 实现拖拽排序详情

    js 实现拖拽排序详情

    这篇文章主要介绍了js 实现拖拽排序,拖拽排序对于小伙伴们来说应该不陌生,平时工作的时候,可能会选择使用类似Sortable.js这样的开源库来实现需求。但在完成需求后,大家有没有没想过拖拽排序是如何实现的呢?感兴趣得话一起来看看下面文章得小心内容吧
    2021-11-11

最新评论