1. 为什么UniApp H5开发会遇到跨域问题?
第一次用uni.request请求后端接口时,看到控制台报错"Access-Control-Allow-Origin"的时候,我整个人都是懵的。明明Postman能正常调用的接口,为什么在H5页面就报错?后来才明白这是浏览器的同源策略在作祟。
现代前端开发基本都是前后端分离架构,前端跑在localhost:3000,后端API在api.yourdomain.com。浏览器出于安全考虑,默认禁止这种跨域请求。而在UniApp打包成App或小程序时,其实没有这个限制,问题就出在H5环境——它本质上就是个网页。
我见过不少新手开发者的"野路子"解决方案:有的让后端直接关闭CORS校验(安全隐患极大),有的改用JSONP(现在很多API已不支持),还有的甚至要求用户手动关闭浏览器安全设置(简直离谱)。其实在开发阶段,最简单的方案就是配置devServer的proxy。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 三分钟搞定proxy基础配置
打开你的manifest.json文件,找到(或新建)h5节点。这里有个坑要注意:一定要切换到"源码视图"才能修改,可视化编辑器是看不到完整配置项的。配置模板长这样:
json复制"h5": {
"devServer": {
"proxy": {
"/api": {
"target": "https://your-real-api.com",
"changeOrigin": true,
"secure": false
}
}
}
}
我来拆解下这几个关键参数:
- /api:你的请求路径前缀,相当于一个标记
- target:实际的后端接口地址
- changeOrigin:改变请求头中的host值(对付某些后端校验必备)
- secure:关闭HTTPS证书验证(本地开发时常用)
配置完后,当你在代码里调用:
javascript复制uni.request({
url: '/api/user/list'
})
实际发出的请求会自动变成https://your-real-api.com/api/user/list,完美绕过浏览器同源限制
