业务域名配置入口在微信公众平台「开发管理」→「开发设置」→「业务域名」→点击「新增」,需下载校验文件并置于域名根目录下,确保可通过https直接访问且返回纯文本,域名须备案、仅支持英文/数字/短横线、不带路径和端口。

web-view 组件能用的前提,是业务域名已在小程序后台完成配置且审核通过。个人类型账号、小游戏账号不支持该能力,这点必须先确认。
业务域名配置入口在哪?
登录 微信公众平台 →「开发管理」→「开发设置」→「业务域名」→ 点击「新增」。注意不是「服务器域名」,那里只管 request、downloadFile 等网络请求,和 web-view 无关。
校验文件怎么放才有效?
新增域名时,平台会生成一个类似 6ynZPDvfTF.txt 的校验文件。你必须把它放到该域名的根目录下,确保:
解析微信公众号文章,提取标题、作者、正文、图片等信息。用户发送链接(mp.weixin.qq.com)时触发,自动提取内容并可保存至飞书表格。
- 可通过
curl https://your-domain.com/6ynZPDvfTF.txt直接返回文件内容(纯文本,无 HTML 包裹、无重定向、无状态码非 200) - 不能用浏览器访问测试——有些 CDN 或 Nginx 会自动加 HTML 头,导致校验失败
- 域名必须是
https协议,不能带路径后缀(如https://a.b.cn/✅,https://a.b.cn/abc/❌) - 新备案域名需满 24 小时后才能提交配置
uni-app 项目里要做什么?
uni-app 本身不参与业务域名校验,它只负责渲染 web-view。但要注意:
-
<web-view src="https://your-domain.com/page"></web-view>中的src必须是已配置的业务域名下的合法子路径(支持通配,如配置了https://a.b.cn,则https://a.b.cn/foo/bar也允许) - 如果使用云模板或营销组件(如大转盘),它们内部可能依赖
web-view加载活动页,此时同样受业务域名限制 -
manifest.json中的mp-weixin配置项与业务域名无关,别误配到downloadFile.domainList或request.domainList里
常见失败原因有哪些?
配置完成后仍报“invalid domain”或白屏,大概率是这些细节没踩准:
- 域名未备案,或备案主体与小程序主体不一致
- 校验文件被 Nginx 自动 gzip 压缩,返回的是二进制而非明文
- CDN 缓存了 404 响应,实际文件已上传但缓存未刷新
- 用了 IP 地址或含端口的地址(如
https://1.2.3.4:8080),微信明确禁止 - 域名含下划线或中文字符,只允许英文、数字、短横线(
-)
web-view 页面会立刻不可用——这个影响是即时且无缓冲的。










