使用proxytable 配置解决 vue-cli 的跨域请求问题【推荐】

时间:2021-05-25

本文适用人群:

  • 会使用 vue-cli 搭建一个基本的 vue webpack 项目,本文的目录结构基于 webpack 模板结构
  • 懂得 axios 基本用法

问题导向

日常开发中,前端经常需要通过 ajax 从后端获取数据。而在这种前后端分离的开发模式下,往往前端项目与后端项目的 IP地址、端口号、协议 大概率是不一样的,由于浏览器的安全策略设定,不进行相应配置的话,前端的请求就会被浏览器拦截掉啦。

假设某个页面组件在加载的时候会向后端发送一个请求,然后根据返回的结果来渲染页面。代码示例如下:

前端项目通过 npm run dev 运行在 localhost:8081 上,

后端项目通过 apache 运行在 localhost/test/public/api/books 上

<template> <div class="hello"> <ul> <li v-for="book of books">{{book.name}}</li> </ul> </div></template><script> import axios from 'axios'; export default { name: 'HelloWorld', data() { return { books: [] } }, created(){ let self = this; axios.get("http://localhost/test/public/api/books") .then((response)=>{ self.books = response.data; }); } }</script>

直接访问后端链接,将能得到以下返回内容:

[ {"name":"javascript \u4ece\u5165\u95e8\u5230\u653e\u5f03"}, {"name":"\u9888\u690e\u75c5\u5eb7\u590d\u6307\u5357"}, {"name":"\u89c6\u529b\u4fdd\u62a4\u6307\u5357"}]

但是当我们在浏览器中运行前端页面,会报错!控制台打印如下:


可见,浏览器对于跨域访问进行了限制,因为在例子中前端项目url与后端项目url的端口号不相同,所以浏览器拦截了我们的请求。

解决方案

解决方式有很多种,包括可以很简单粗暴地让后端代码设置一个 Access-Control-Allow-Origin 头来解决这个问题。但是,在实际开发中,后端的小哥哥们才不会理会你这个羞耻的小请求呢~

那怎么办咧~

其实我们可以通过配置 vue 项目中的 config/index.js 来解决问题。

将 dev 中的 proxyTable 改为如下:

proxyTable: { '/api': { target: 'http://localhost/test/public/api/', changeOrigin: true, pathRewrite: { '^/api': '' } }},

接着,再将 vue 组件页面中的 ajax 请求代码改为如下:

// 改为这样,原来是这样:axios.get("http://localhost/test/public/api/books")axios.get("/api/books")

重新运行 npm run dev ,运行效果如下:

当当当!成功!

为什么这么做?

当我们打开浏览器的开发者工具查看一下网络请求就会发现,这个 ajax 请求竟然是向我们前端的 webpack-dev-server 发送的:

而且居然能返回正确的数据???

浏览器有安全策略限制,但是第三方的服务(服务器)没有呀,所以我们可以通过让浏览器访问前端开发服务器的url,让前端开发服务器去向后端服务器发送请求,再返回数据给浏览器,这样子就不存在跨域问题啦。

当我们在配置中这么写时:

proxyTable: { '/api': { target: 'http://localhost/test/public/api/', }},

对于8081端口的开发服务器而言,所有以 /api 开头的 uri 都会被转发到 http://localhost/test/public/api/ ,

也就是说,在浏览器中访问 localhost:8081/api/books ,前端开发服务器就会向 http://localhost/test/public/api/api/books 请求数据。就是简单粗暴地在 target 之后拼接上当前的uri。

会发现这样子做,实际的 url 中多了一个 /api ,不满足我们的需求,所以可以通过 pathRewrite 将这几个字符串替换掉。

// 将 "/api" 开头的 url 中的 "api" 替换成 空proxyTable: { '/api': { target: 'http://localhost/test/public/api/', pathRewrite: { '^/api': '' } }},// 根据上面的规则// 当在浏览器访问 localhost:8081/api/books// 则实际访问的是 http://localhost/test/public/api/books// 假设设置成 pathRewrite: {'^/api': '/somethingnew'}// 当在浏览器访问 localhost:8081/api/books// 则实际访问的是 http://localhost/test/public/somethingnew/books

而配置项 changeOrigin: true 则是设置了前端开发服务器向后端发送请求时 HTTP 包中的 HOST 字段。当设置为 true 时,HOST 会被设置成目标地址(target)中的主机。当后端服务器是虚拟主机时,这个选项显得尤为重要,或者说,同一个IP绑定了多个服务器服务时显得尤为重要。不设置的话,可能会导致请求不到数据。

更多的 proxyTable 可用参数可以参考 http-proxy-middleware 的文档

声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

相关文章