在 vite 项目中,使用代理插件的核心做法是在 vite.config.js 的 server.proxy 配置项中定义目标路径与转发规则。通过设置 target 指定后端服务地址,并开启 changeorigin 处理跨域问题,vite 开发服务器会自动拦截匹配的路径请求并将其转发至目标服务器,从而解决本地开发时的跨域限制。

Vite 代理插件怎么配置基础转发规则
配置基础转发规则需要修改 vite.config.js 文件,在 defineConfig 导出的对象中增加 server 属性,并在其下定义 proxy 对象。该对象以字符串键名对应前端请求路径前缀,值为包含 target 和 rewrite 等属性的配置项。当请求路径匹配键名时,Vite 会将请求转发到 target 指定的 URL,并根据 rewrite 函数或字符串规则调整路径。这种配置方式简单直接,适用于大多数前后端分离的开发场景,能够确保前端代码无需修改即可调用后端接口。

import { defineConfig } from 'vite';
export default defineConfig({
server: {
proxy: {
'/api': {
target: 'http://localhost:3000',
changeOrigin: true,
rewrite: (path) => path.replace(/^\/api/, '')
}
}
}
});
上述代码将 /api 开头的请求转发到 http://localhost:3000,并移除路径中的 /api 前缀。例如,请求 /api/users 将被转发为 http://localhost:3000/users。changeOrigin: true 确保请求头中的 Host 字段被修改为目标地址,避免后端因域名不匹配而拒绝请求。运行 vite 命令后,打开浏览器访问 http://localhost:5173/api/users,实际数据将从 http://localhost:3000/users 获取。
如何配置代理以支持 WebSocket 连接
支持 WebSocket 连接需要在代理配置中添加 ws: true 选项。默认情况下,Vite 的代理仅处理 HTTP 请求,启用 ws 后,Vite 会升级连接协议,将 WebSocket 握手请求转发到目标服务器,并保持长连接。这对于需要实时通信的应用(如聊天室、在线游戏)至关重要。配置时,只需在对应的代理对象中设置 ws: true,其余参数与 HTTP 代理相同。Vite 会自动处理 WebSocket 帧的转发,开发者无需额外编写代码。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import { defineConfig } from 'vite';
export default defineConfig({
server: {
proxy: {
'/ws': {
target: 'ws://localhost:4000',
ws: true,
changeOrigin: true
}
}
}
});
上述代码将 /ws 开头的 WebSocket 请求转发到 ws://localhost:4000。前端代码中创建 WebSocket 连接时,使用 new WebSocket('ws://localhost:5173/ws'),Vite 会自动将其升级为到 ws://localhost:4000 的连接。测试时,可在终端启动一个简单的 WebSocket 服务器,或使用在线工具验证连接是否成功建立。注意,ws 选项仅对 WebSocket 协议有效,不影响普通 HTTP 请求。
代理插件如何处理非标准端口号的请求
当后端服务运行在非标准端口号(如 :8080 或 :9000)时,代理插件的处理方式与标准端口(如 :80 或 :443)完全一致,无需特殊配置。关键在于 target 值必须包含完整的端口号,且 changeOrigin 设置为 true 以确保跨域兼容。Vite 的代理模块基于 http-proxy-middleware,它自动处理端口解析和连接建立,无论端口是否标准。开发者只需确保目标服务在该端口上监听,并在代理配置中正确指定即可。若遇到连接失败,通常是因为防火墙阻止了非标准端口,或目标服务未正确绑定到 0.0.0.0。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










