manifest.json代理配置优先级更高,因其是uni-app官方原生支持的配置入口,HBuilderX和CLI工具优先读取并完全覆盖vue.config.js中的同名配置。

直接在 manifest.json 里配 h5.devServer.proxy,比写 vue.config.js 更稳、更优先、不用额外装依赖。
为什么 manifest.json 代理配置优先级更高
uni-app 构建流程中,manifest.json 是官方原生支持的配置入口,HBuilderX 和 CLI 工具都会优先读取它里面的 h5.devServer 配置。如果同时存在 vue.config.js 和 manifest.json 的代理设置,后者会完全覆盖前者 —— 这不是 bug,是设计如此。
常见踩坑点:
- 改了
vue.config.js没生效?先检查manifest.json是否已有同路径的proxy配置 - 在 HBuilderX 可视化界面改过 H5 设置后,
manifest.json会自动生成h5节点,但默认不含devServer,需手动补全 -
manifest.json是 JSON 格式,不能写注释、不能用单引号、不能有尾逗号,否则启动报错:Invalid JSON in manifest.json
manifest.json 中 proxy 的关键参数怎么填
以代理 /api 到 https://api.example.com 为例,完整片段如下:
{
"name": "my-app",
"appid": "",
"description": "",
"versionName": "1.0.0",
"versionCode": "100",
"transformPx": true,
"app-plus": { /* ... */ },
"h5": {
"devServer": {
"disableHostCheck": true,
"proxy": {
"/api": {
"target": "https://api.example.com",
"changeOrigin": true,
"secure": false,
"pathRewrite": {
"^/api": ""
}
}
}
}
}
}
各参数作用:
-
disableHostCheck: true:允许非 localhost 域名访问开发服务器(真机调试必备) -
target:必须带协议(http://或https://),不能只写域名 -
changeOrigin: true:重写请求头中的Host字段为目标地址,否则某些后端(如 Nginx、Spring Boot)会拒绝请求 -
secure: false:当target是 HTTPS 且证书不合法(如自签名)时,必须设为false,否则连接被拒绝 -
pathRewrite:正则替换路径前缀,"^/api"必须加^锚定开头,否则可能误删部分路径
多个 API 域名要代理,怎么写
直接在 proxy 对象下并列写多个键,互不干扰:
"proxy": {
"/user-api": {
"target": "https://user-service.example.com",
"changeOrigin": true,
"secure": false,
"pathRewrite": { "^/user-api": "" }
},
"/order-api": {
"target": "https://order-service.example.com",
"changeOrigin": true,
"secure": false,
"pathRewrite": { "^/order-api": "" }
}
}
注意:
- 路径前缀不能重叠,比如不能同时有
"/api"和"/api/v1",后者会被前者提前匹配 - 如果后端接口本身带路径(如
https://api.com/v2/),target就得写全,pathRewrite仅处理前端发出的请求路径 - WebSocket 代理需要额外加
"ws": true,且target必须是ws://或wss://
最易忽略的是:改完 manifest.json 后必须**重启开发服务**(关掉再 npm run dev:h5 或点击 HBuilderX 的「运行」按钮),热更新不会重新加载代理配置。另外,生产环境打包后的 H5 不走 devServer,代理配置完全无效 —— 上线前务必确认后端已配好 CORS 或使用 Nginx 反向代理。











