发布后的H5静态文件无运行时服务器，开发期代理（vite.config.ts等）全部失效；必须由Nginx/Apache配置反向代理，将/api/请求转发至后端并正确设置proxy_pass和Host头。
发布后的 H5 静态文件不支持任何代理配置，必须由部署服务器（如 Nginx）做反向代理 —— vite.config.ts、manifest.json、vue.config.js 里的 proxy 全部失效。
为什么 build 后的 H5 不能自己代理
uni-app 的 npm run build:h5 输出的是纯静态 HTML/JS/CSS 文件，没有运行时服务器。所有开发期的代理（server.proxy、h5.devServer.proxy）只在 npm run dev:h5 启动的 Vite 开发服务器中生效，打包后就没了。
浏览器直接加载 index.html，所有 uni.request({ url: '/api/login' }) 请求都会发向当前页面所在域名（比如 https://your.com/api/login），如果后端不在同源，就会触发 CORS 错误。
- 不是代码没写对，是请求根本没经过你本地的开发代理
- 也不是 uni-app 框架限制，这是浏览器+静态部署的天然行为
- 生产环境唯一合法路径：让 Nginx/Apache 把
/api/xxx转发到真实后端
Nginx 反向代理配置要点
把生成的 unpackage/dist/build/h5 目录部署到 Nginx 的 root 下后，在 server 块里加 location 规则：
location ^~ /api/ {
proxy_pass https://your-backend-domain.com/;
proxy_set_header Host your-backend-domain.com;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
-
proxy_pass末尾带/表示“去掉/api/前缀再转发”，否则会拼成https://.../api/xxx -
proxy_set_header Host必须显式设置，否则某些后端（如 Express + cors 中间件）会因 Host 不匹配拒绝请求 - 不要加
add_header 'Access-Control-Allow-Origin' '*'—— 这是绕过 CORS 的错误做法，且可能被浏览器拒绝（带凭证时不允许用*）
常见 404 / 502 问题排查
代理配了但接口仍失败，优先检查这几项：
- 后端服务是否真实可访问？用
curl -v https://your-backend-domain.com/api/user直连验证 - Nginx 是否重载配置？执行
nginx -t && nginx -s reload -
proxy_pass的协议（http://vshttps://）和端口是否与后端一致？ - 后端是否监听了
0.0.0.0而非127.0.0.1？Nginx 是从服务器本机发起请求，不是 localhost - 防火墙或安全组是否放行了后端端口？尤其云服务器
最易被忽略的一点：Nginx 的 proxy_pass 和后端路径必须严格对应，少一个斜杠、多一个路径段，后端就收不到请求 —— 它不像开发代理那样有自动 rewrite 容错。
