配置小程序业务域名时，子域名需要逐一独立添加并完成校验，不能通过配置主域名来覆盖子域名。
为什么子域名不能直接复用主域名配置
微信小程序的业务域名校验机制，针对的是具体域名而非域名层级，你在小程序后台添加了example.com，系统会默认只信任这个精确域名，api.example.com或static.example.com并不会被自动纳入白名单。
行业共识认为，微信这么做是为了规避泛域名带来的安全风险，如果允许父域名覆盖全部子域名，攻击者只需控制一个低权重子域名就能发出合法请求,整个安全体系就形同虚设。
所以在动手配置前，先确认一件事：你实际要请求几个子域名,每个子域名都需要单独走一遍添加和校验流程。
小程序业务域名怎么配置：一步步实操
前置条件：备案与HTTPS
- 域名必须完成ICP备案，且备案主体与小程序主体一致
- 业务域名必须支持HTTPS，证书有效且链完整
- 以
https://开头，不能使用IP地址或端口号 - 校验文件必须能通过
http://和https://两种协议访问
小程序业务域名需要备案吗？需要，微信对业务域名的备案查得比较严格，未备案的域名在添加时就会被直接拦截,这一步没有绕过的空间。
获取并上传校验文件
- 登录微信公众平台，进入小程序管理后台
- 点击左侧”开发管理” → “开发设置” → “业务域名”
- 在添加域名弹窗中，复制系统生成的校验文件
xxxxxx.txt - 将该文件上传到对应子域名的根目录下
- 确认能通过浏览器访问该文件（网址格式为
https://子域名/校验文件名.txt）
这一步是很多人卡住的地方，校验文件必须放在子域名的根目录，不是主域名的根目录，也不是任意子目录，每个子域名各自都有独立的根目录,需要分别放置。
在后台添加域名并完成验证
- 在业务域名配置页，填入完整的子域名地址，例如
https://api.example.com - 系统自动发起校验，检查文件是否可访问
- 校验通过后，点击保存，该子域名即刻生效
如果你有多个子域名，比如api.example.com、img.example.com、mp.example.com，需要重复上述步骤逐个添加，目前单个小程序最多可配置200个业务域名，对于绝大多数应用场景,这个额度完全够用。
微信小程序业务域名设置流程的核心就四个字：逐个添加，后续新增子域名时，同样要回到这里走一遍校验,没有快捷通道。
小程序业务域名子域名支持吗：两种典型场景
固定子域名：正常添加即可
业务域名直接支持任意级别的子域名，比如a.b.example.com这种三级域名，只要你能提供校验文件并通过HTTPS访问，就能成功添加，每个层级之间互相独立,不会因为添加了二级域名就自动放行三级域名。
泛解析子域名：不支持通配符
部分开发者习惯用.example.com这种泛解析方案，以便动态生成多个子域名，但微信业务域名配置不支持通配符
，你在后台写.example.com,系统会直接提示格式错误。
如果确实需要让用户访问动态子域名,有两条可行路径：
- 把所有可能的子域名穷举后逐一添加，仅适用于子域名数量可控的场景
- 改用固定入口域名，由服务端做路由分发，避免出现大量不固定子域名
小程序业务域名和request域名有什么区别
这是很多人在实际开发中容易混淆的一组概念，request合法域名解决的是wx.request这类网络接口的授权问题，而业务域名承载的是网页跳转和web-view组件的加载权限。
| 对比项 | 业务域名 | request域名 |
|---|---|---|
| 覆盖范围 | web-view网页、跳转链接 | 网络请求接口 |
| 校验方式 | 需上传校验文件到根目录 | 仅做HTTPS和备案校验 |
| 通配符支持 | 不支持 | 不支持 |
| 数量上限 | 200个 | 200个 |
| 适用范围 | 小程序内嵌网页 | 接口调用 |
业务域名的校验门槛更高，因为它直接决定小程序能打开哪些外部网页，一个子域名如果在业务域名里没配置，哪怕request域名配了,页面照样白屏。
常见报错与排查思路
校验文件无法访问
报错提示”校验文件校验失败”时,按顺序排查：
- 文件是否放在子域名根目录而非上级目录
- 文件名是否被修改或带上后缀（比如
.txt.txt） - HTTPS证书是否有效，证书过期会导致访问异常
- 是否有防盗链或UA限制的中间层拦截了微信爬虫
页面明明配了域名却打不开
如果域名状态显示”已添加”，但web-view组件加载页面时仍然报错,先检查两点：
- 页面链接是否与配置的域名完全一致，包括
https://前缀 - 页面内部有没有跳转到未配置的其他域名，跳转同样受业务域名约束
业内专家指出，相当一部分”配了却用不了”的案例，根源不在小程序后台，而是业务逻辑里隐藏的重定向链路,排查时要留意跳转目标地址。
Q&A：小程序业务域名配置常见问题
一个主域名下的多个子域名能否共用同一个校验文件？
不能，每个子域名都要有独立根目录下的校验文件，文件名可以相同，但存放位置必须分别在各自的根目录，文件内容由微信后台按域名分别生成,不能拿A域名的文件放到B域名下使用。
业务域名添加后能立即生效吗？
校验通过并保存后立即生效，无需等待审核，但部分情况下开发者工具和服务商需要同步刷新缓存，如果实测未生效，可以关闭小程序后台重新进入，或在开发者工具中执行清缓存操作，线上版本不会受缓存影响,用户可以正常访问。
换服务器或迁移域名时要怎么处理？
先在新域名对应的小程序后台完成业务域名添加和校验，确认页面能正常打开后，再把原域名从配置中移除，整个过程无需小程序发版，需要注意的是，移除旧域名前务必确认没有线上页面仍在引用它,否则会出现页面加载失败的后果。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/620548.html
