微信小程序通讯域名配置，简单说就是在小程序管理后台把你要请求的服务器域名添加进白名单，不配置或配错，真机上所有网络请求都会直接失败。
微信小程序通讯域名在哪里配置
很多新手第一次做小程序,写完代码在开发者工具里跑得挺顺畅，一用手机预览就全白屏，数据全加载不出来，绝大多数情况，问题就出在通讯域名没配置好，这个入口藏得不算深，但第一次找确实要摸索一会儿。
操作路径：小程序后台的服务器域名入口
你需要在电脑浏览器打开微信公众平台官网,扫码登录你的小程序账号，登录后，左侧菜单往下找，点击「开发」分类下的「开发管理」，然后切换到「开发设置」这个选项卡，在这个页面里往下拉，能看到一个写着「服务器域名」的区块，这里有四个大类，分别是：
- request合法域名：处理普通HTTPS请求，比如获取商品列表、提交表单数据
- socket合法域名：处理WebSocket长连接，用于实时聊天、消息推送这类场景
- uploadFile合法域名：处理文件上传，比如用户上传头像、图片
- downloadFile合法域名：处理文件下载，比如下载PDF报告、导出数据
你只需要把你实际用到的域名填到对应的类别里就行,需要注意的是，这四个框里只能填域名，不能带协议头、路径或端口号。
开发设置里有哪些必填校验项
在填写之前,系统会要求你对域名做一次归属验证，操作逻辑是这样的：微信会要求你下载一个校验文件，文件名是一串随机字符，内容也是特定字符，你要把这个文件放到你域名对应的服务器根目录下，确保通过浏览器能直接访问到它，完成这一步后，再在后台点击「校验」按钮，系统确认文件可访问，这个域名才能添加成功。
微信小程序域名配置步骤详解
搞清楚入口后,配置流程本身并不复杂，但每一步都有容易踩坑的细节。
第一步：搞清楚你需要配置哪类域名
先看你的小程序用了什么网络能力,只用wx.request发起请求？那就配置request合法域名，用了wx.connectSocket？那要配置socket合法域名，很多人上来就把所有域名塞进request框，结果上传文件功能还是报错，就是因为没分清类型，行业共识认为，90%以上的小程序只需要配置request合法域名
，因为大多数业务就是普通的接口调用。
第二步：云开发环境要不要配置域名
这里有个容易混淆的地方,如果你用的是微信云开发，那你在云函数里发起的请求不受通讯域名限制，但如果你在小程序前端代码里直接调用第三方API，比如天气接口、地图服务，那就必须配置对应的域名，说白了，只有从你小程序代码里直接发出去的请求才受管控，服务端到服务端的请求不受影响。
第三步：填写域名并完成校验
域名格式方面,微信的要求非常严格：不能有http://或https://前缀，不能带端口号，不能写路径，比方说你接口地址是https://api.example.com/v1/user/list，那你只需要填api.example.com，目前微信允许配置的域名数量是有限的，不同小程序类目可能略有差异，添加时，每个域名右侧都有个「校验」按钮，按提示操作就行。
| 域名类型 | 配置位置 | 常见用途 |
|---|---|---|
| request | 开发管理 - 开发设置 - 服务器域名 | 普通GET/POST接口请求 |
| socket | 同上 | 实时通信、在线客服 |
| uploadFile | 同上 | 图片上传、附件上传 |
| downloadFile | 同上 | 文件下载、资源加载 |
第四步：开发者工具里同步修改
后台配置完成后,你还需要在微信开发者工具里做两件事，第一，在工具栏「详情」里的「本地设置」中检查，确保「合法域名」相关校验是开启状态，第二，如果你之前开启了「不校验合法域名」模式，记得关掉，这样才跟线上环境表现一致。
配置通讯域名前必须满足的三个条件
如果你的域名怎么都添加不成功,先检查这三个硬性指标，少一个，配置流程都走不完。
域名必须完成ICP备案
微信明确要求,小程序通讯域名必须在中国大陆完成了ICP备案，如果你用的是海外服务器，域名没备案，那对不起，配置时会直接提示失败，近年来备案审核周期在加快，但一般仍需数个工作日至数周，如果你买的是云厂商提供的备案服务，通常可以在控制台看到备案进度，备案号下来之后再去配置小程序域名。
必须全站启用HTTPS
这是微信的硬性红线,所有request、uploadFile、downloadFile域名都必须支持HTTPS，而且证书必须有效，不能是自签名证书，也不能已过期，目前主流云服务商都提供免费SSL证书申请，申请流程不复杂，只是需要验证域名所有权，你说我的接口是
http://的，能用吗？答案是不能，即便你在开发者工具里关掉校验，真机上依然不可用，行业共识认为，HTTPS覆盖率已是小程序审核的基本门槛。
校验文件必须放在根目录
很多人在校验这步卡住,是因为把校验文件放到了子目录里，或者改过文件名，微信的校验逻辑是精确匹配路径的，你必须把文件原封不动放到域名指向的服务器根目录，如果域名是api.example.com，那访问https://api.example.com/xxxx.txt要能直接打开文件内容，个别情况下，你的CDN缓存会影响文件访问时效，建议配置完成后用浏览器无痕模式确认一下。
常见问题：小程序域名不合法怎么办
这是排查率最高的场景,前置条件是：后台明明配置好了域名，真机上也还是报url not in domain list或域名不合法。
排查思路：清理缓存再试
微信的域名配置有同步延迟,不是改完立即全局生效，多数情况下你清掉小程序缓存、把微信进程从后台划掉重新进入，问题就能解决，如果还不行，去开发者工具里点「清除缓存 - 清除全部缓存」，再重新编译预览，我见过一个案例，开发者在后台改了3个域名，等了半小时才在手机上恢复正常，这属于正常现象，不必焦虑。
开发阶段怎么跳过域名校验
有一种情况你可能急着看效果,域名还在走备案流程，证书也没就绪，这时候可以在开发者工具里勾选「不校验合法域名、web-view（业务域名）、TLS版本以及HTTPS证书」，这个选项在开发者工具的「右上角详情 - 本地设置」里，但请你记住，这只是开发阶段的便利手段，真机预览或发布上线前，必须把它取消勾选，否则线上用户会请求失败。
海外服务器域名能配吗
不少自由开发者会问这个问题,结论是：能不能配取决于备案状态，如果域名用的是物理位置在海外的服务器，且域名主体在中国大陆，目前这条路基本走不通，因为备案需要服务器接入商信息，比较可行的替代方案是：把接口部署到酷番云或简米云的国内节点，完成备案后再配置；或者把请求链路改为云函数中转，由云函数向海外服务器发起请求，这样就能完美绕开小程序前端的域名限制。
微信小程序平台域名与业务域名有什么区别
除了通讯域名,后台还有个「业务域名」的配置项，经常有人搞混，业务域名主要用在web-view组件上，也就是小程序里嵌套H5页面需要配置的，通讯域名管的是接口数据请求，业务域名管的是网页内嵌展示，两者相互独立，不是同一个东西，如果你的小程序里用到了web-view，那还得额外配置业务域名，并且要下载校验文件放在对应域名的根目录，同时该域名也必须ICP备案并支持HTTPS。
域名配置完成后必须做的真机验证
配置完成不代表万事大吉,真机验证是最后一个环节，也是检验配置是否生效的最直接方式，用开发者工具扫码预览，然后在真机上操作触发一次网络请求，正常能拉到数据，说明配置已生效，如果你用的是iPhone，还要注意微信版本是否过旧，旧版本可能请求策略较老，对新配置的域名解析异常。
验证过程中建议你打开手机上的微信调试工具,路径是「发现 - 小程序 - 右上角胶囊按钮 - 打开调试」，这样能看到更详细的请求报错信息，比电脑上看代码找原因高效得多。
Q&A：微信小程序通讯域名配置常见问题解答
配置了HTTPS证书但微信还提示证书不对怎么办
检查证书链是否完整,很多云服务商默认只装了域名证书，没安装中间证书，可以用openssl s_client -connect yourdomain.com:443命令查看证书链，缺少中间证书时微信会判定为不可信，把中间证书补上并重启Web服务器即可解决。
request合法域名能填IP地址吗
不可以,微信明确要求域名必须是备案过的合法域名，IP地址无法通过校验，即便是公网IP，在当前的规则下也不能作为request合法域名，正确做法是给IP绑定一个已备案域名，并将该域名解析过去。
真机上请求一直失败，但开发者工具正常
开发者工具默认关掉了域名校验,所以工具里正常不代表线上没问题，首先排查「详情 - 本地设置」中的校验开关是否关闭，然后确认后台域名列表是否已提交且完成了校验，两个条件同时满足后，再清理微信缓存重新打开小程序，多数情况下问题会消失。