Vite 配置代理 Proxy,避免跨域和重复编写url的问题
2021年8月 · 预计阅读时间: 2 分钟
我们在编写前端项目的时候,经常会遇到跨域的问题,当我们访问后端 API 的 URL 路径时,只要域名、端口或访问协议(如 HTTP 和 HTTPS)有一项不同,就会被浏览器认定为跨域。另外我们也会经常重复编写后端的域名,例如
https://example.com/api/some_end_point
,
https://example.com/api/other_end_point
,针对这两种情况,可以直接用同一个配置来解 决,即代理配置。
不管是 Vite 还是 Webpack,这些打包工具都支持设置前端代理,它们能够把对某一段 URL 的访问直接转换成另一个真实的后端 API 地址,这样前后端就视为使用了相同的域名、协议和端口,就避免了跨域的问题,还能避免繁琐的反复编写域名。
配置 Vite Proxy
我们这里以 Vite 的配置为例,来看一下如何给 API 请求设置代理。在 Vite 编写的项目里边,有一个
vite.config.js
配置文件,里边是关于 Vite 的配置项,可以在里边配置代理。假如我们前端项目路径为
http://localhost:3000
,需要代理所有以
/api
开头的 API 请求,把它转发到
http://localhost:3001
,并且后端的 API 路径中不带
/api
前缀,需要自动去掉
/api
前缀,如下图所示:
那么可以使用下面这样的配置:
// vite.config.js
import { defineConfig } from "vite";
export default defineConfig({
server: {
proxy: {
"/api": {
target: "http://localhost:3001",
changeOrigin: true,
rewrite: (path) => path.replace(/^\/api/, ""),
},
},
},
});
在 vite 导出的配置里边:
server
配置项。
server
配置项下边添加
proxy
配置项,值为一个对象,属性名为要代理的 URL 路径段,值为相关的配置。
/api
,来配置转发前端
http://localhost:3000/api
开头的所有请求路径。
在 proxy 配置对象中:
target
,为实际的后端 URL,它会追加到属性名配置的
/api
这个片段的前面,例如访问
/api/some_end_point
会转换为
http://localhost:3001/api/some_end_point
。
changeOrigin
,是否改写 origin,设置为 true 之后,就会把请求 API header 中的 origin,改成跟
target
里边的域名一样了。
rewrite
可以把请求的 URL 进行重写,这里因为假设后端的 API 路径不带
/api
段,所以我们使用
rewrite
去掉
/api
。给
rewrite
传递一个函数,函数的参数
path
是前端请求的 API 路径,后面直接使用了 replace() 方法,在里面写一个正则表达式,把
/api
开头的这一段替换为空。
这样 vite 的代理就配置好了。在实际前端请求的过程中,就可以直接使用
/api/some_endpoint
这样的形式了: