添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
跳到主要内容位置

Vite 配置代理 Proxy,避免跨域和重复编写url的问题

张旭乾

我们在编写前端项目的时候,经常会遇到跨域的问题,当我们访问后端 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 这样的形式了: