业务域名和授权域名虽然都在微信公众平台后台配置,但服务对象完全不同:业务域名管的是小程序内web-view加载的网页,授权域名管的是小程序向服务器发请求的地址。很多开发者第一次配置时都容易混淆,配置错了要么页面白屏,要么接口调不通,这篇文章把两者的区别、适用场景和设置步骤一次讲清楚,看完直接照着操作就行。
业务域名和服务器域名到底有什么区别
先从最直观的角度来看:这两个域名分别服务于小程序的不同运行阶段。
业务域名是给小程序里的web-view组件用的,小程序是个封闭的沙盒环境,想要嵌入一个外部H5页面,必须提前把那个页面的域名加到业务域名白名单里,不加?页面直接打不开,白屏一片。
授权域名则管的是网络请求,小程序里的wx.request、wx.uploadFile、wx.downloadFile这些API,请求的目标域名必须事先配置到服务器域名白名单里,如果没配,控制台报错,请求发不出去。
下面用一个表格来对比,方便你记忆:
| 对比维度 | 业务域名 | 授权域名 |
|---|---|---|
| 服务对象 | web-view组件加载的H5页面 | request/uploadFile/downloadFile等API |
| 校验方式 | 需下载校验文件放到服务器根目录 | DNS解析校验,4小时内生效 |
| 数量限制 | 单个域名不超过20个 | 每个分类(request/uploadFile/等)不超过20个 |
| 关键约束 | 不支持IP,仅限HTTPS | 不支持IP和localhost,仅限HTTPS |
| 配置入口 | 小程序后台→开发→开发设置→业务域名 | 小程序后台→开发→开发设置→服务器域名 |
业务域名的核心场景是内嵌H5页面,比如电商小程序的秒杀活动页、资讯类小程序的富文本详情页,这些页面如果不想全部用小程序原生代码重写,就可以用web-view去加载已有的H5站点,授权域名则对应着数据请求场景,也就是小程序的业务逻辑需要调用的后端API地址。
行业共识认为,这两类域名几乎是所有线上小程序都需要配置的项,区别只在于你是否有web-view嵌入的需求。
微信公众平台业务域名怎么设置才正确
搞懂了区别,第二步就是实操环节,业务域名的配置相对严格,因为微信要求开发者对嵌入内容负责。
前置条件自查清单
在动手之前,先自查以下条件,缺少任何一项都会导致配置失败:
- 小程序必须是已认证状态,个人类型小程序不支持配置业务域名
- 业务域名必须已备案,且支持HTTPS访问
- 需要准备一个可以修改服务器文件的管理权限,FTP或宝塔面板都行
配置步骤详细拆解
第一步:找到配置入口
登录微信公众平台,点击左侧菜单栏的“开发管理”→找到“开发设置”选项卡→下拉页面找到“业务域名”区块。
第二步:填写域名并验证
输入你要嵌入的域名,例如https://m.yourstore.com,点击“保存并校验”,系统会给你一个命名为xxx.txt的校验文件,下载到本地。
第三步:上传校验文件
通过FTP或服务器管理面板,把这个txt文件上传到对应域名的根目录,注意路径必须是https://m.yourstore.com/xxx.txt能直接访问到才算成功,行业共识认为这一步是卡住最多开发者的环节,常见原因就是文件上传位置错了或者权限不对。
第四步:验证通过
点击“完成”后,微信会重新访问校验文件,确认存在且内容一致,通过后,域名就出现在业务域名列表里了。
配置过程中有几点必须留意:
- 业务域名最大支持20个,超过需替换或申请扩容
- 下载校验文件的域名是
mp.weixin.qq.com,用电脑下载,不要用手机 - 校验文件一旦删除,业务域名就会失效
小程序授权域名在哪里设置
授权域名配置入口和业务域名在同一个页面,只是选项卡不同,在小程序后台的“开发设置”里,“服务器域名”就是授权域名设置区。
这里有几个分类要分清:request合法域名、socket合法域名、uploadFile合法域名、downloadFile合法域名,日常开发90%以上的场景都在配置request合法域名,也就是API接口的地址。
授权域名配置步骤
第一步:进入小程序后台“开发管理”→点击“开发设置”→找到“服务器域名”区域。
第二步:在对应的分类里填写域名,只填域名部分,不用带https://协议头,例如直接写api.yourstore.com。
第三步:点击保存,系统会要求使用管理员微信扫码验证。
第四步:等待微信自动校验域名合法性,这里有讲究微信会检查域名的DNS解析是否存在,不会检查服务器是否真的活着,校验生效时间在4小时内,刚配完立刻调用接口可能还是会报错,稍微等一等就好。
配置过程中的高频翻车点
用真实场景来说明问题,以下三种情况是开发者最容易踩坑的:
接口地址用了IP加端口。例如http://192.168.1.100:8080/api,微信明确禁止IP和localhost格式,仅支持已备案的HTTPS域名,解决思路是买一个域名并配置加端口转发。
能访问但一直报“不在以下request合法域名列表中”。检查一下你的请求是否走了wx.request之外的其他API,比如上传文件的请求必须配uploadFile合法域名,不是配在request分类里。
本地调试模式下一切正常,真机测试就挂。开发者工具默认勾选了“不校验合法域名”,真机没有这个选项,测试时记得在手机预览页面把“开发环境不校验请求域名”关掉,或者直接配置到后台。
业务域名和授权域名能不能共用同一个域名
这是很多开发者关心的实际场景,答案是可以,而且相当一部分项目就是这么干的,假设你的域名是yourdomain.com,
- 把它配置进业务域名,同时也可以配置进request合法域名
- 两个配置相互独立,互不影响
- 校验文件只需要和业务域名绑定,授权域名不做文件校验
也就是说,一个域名完全可以同时服务H5页面和API接口,实际项目中,为了运维方便,多数情况会建议这样配,但要注意,如果两个域名下的服务器互相跳转,比如H5页面里又调了另一个域名的接口,那么另一个域名也需要加到授权域名列表里。
数量限制与超出后的建议
个人认证小程序和企业认证小程序的限额有所不同,多数情况下每个分类的域名数量上限是20个,如果业务域名数量不够用,主要有两个办法:
- 减少不必要的域名数量,将多个子域名合并到同一个主域名下
- 通过微信官方的“服务器域名数量提升”申请通道申请扩容,但审核相对严格
常见问题解答
业务域名和授权域名校验失败怎么办
校验失败通常集中在两类原因:一是业务域名的校验文件没有放置在服务器根目录,或域名备案状态未生效;二是授权域名的子域名解析未生效,解决办法是先用浏览器直接访问校验文件地址,确认能打开再回到后台保存;授权域名则通过在线DNS查询工具确认解析已生效后等待4小时。
我买的域名没有备案能配置吗
微信公众平台业务域名的配置前提是域名已完成ICP备案,这是硬性条件,特别是在部分省份,备案通常需要7到20个工作日,如果想用小程序做web-view嵌入,需要提前规划备案周期,授权域名同样要求备案,这是微信对所有线上名字资源的底线性约束。
买域名时需要注意什么
对于计划长期运营小程序的新手,建议直接购买.cn或.com顶级域名,年费通常在几十元到百元区间,具体看注册商的定价策略,使用云厂商提供的域名服务时,优先选择与服务器同一厂商的产品,方便做解析管理,近年来域名备案周期和规则相对稳定,但步骤细节建议以服务商的最新指引为准。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/623530.html


