引言
很多刚开始做小程序的团队，开发都快做完了，却卡在"请求域名未配置"这一步：开发者工具里模拟器正常，真机预览却报"不在以下 request 合法域名列表中"。这背后其实是两件事没做对——域名本身没备案，以及小程序后台没把域名加进白名单。据公开信息显示，按工信部相关要求，面向国内的小程序及其服务域名需完成备案才能正常提供服务。
本文从买域名开始，把域名解析、ICP 备案、小程序后台配置这一整条链路讲清楚，帮开发团队少走弯路。
内容概述
小程序要联网请求自己的服务器，背后的逻辑是：先注册一个域名 → 把域名解析到自己的服务器 IP → 给域名完成 ICP 备案 → 在小程序后台把该域名配置为"request 合法域名"并启用 HTTPS → 真机才能正常访问。整个链路任何一环没做，都会导致请求失败。下面按步骤拆开说明。
核心要点
1. 域名注册与选择
- 选后缀：常见的 .com、.cn、.net 都可以，建议选简短、好记、和品牌相关的；
- 注册商：在正规域名注册商处购买，注意域名所有人信息要和后续备案主体一致；
- 别买已被滥用的域名：如果是二手域名，先确认有没有被小程序或微信封禁过，否则加白名单也可能被拦。
域名所有人信息要和将来备案的主体（企业或个人）一致，否则备案会被退回。
2. 域名解析
域名注册后，需要把它解析到服务器的公网 IP 上，服务器才能响应请求： - A 记录：把域名（如 api.example.com）指向服务器 IP； - CNAME：如果用的是云服务商的 CDN 或负载均衡，按服务商给的 CNAME 地址配置； - 多级域名常用：建议把接口域名（如 api.example.com）和图片域名（如 img.example.com）分开，便于后续扩展。
解析生效通常需要几分钟到几十分钟，可以用 ping 或在线解析工具确认是否生效。
3. 域名 ICP 备案
按现行规定，域名指向中国大陆境内服务器时，需要完成 ICP 备案： - 备案主体：和域名所有人、小程序主体保持一致； - 接入服务商：在服务器所在的云服务商处提交备案，由其代为上报； - 备案周期：通常数周到数月不等，以各地管局实际办理时效为准； - 小程序备案：除了域名备案，小程序本身也需要完成备案，两者不能互相替代。
如果服务器在境外，则域名不需要在国内 ICP 备案，但访问速度和合规性要自行评估。
4. 小程序后台合法域名配置
域名备案通过、HTTPS 部署好之后，要在小程序后台加白名单： - request 合法域名：小程序发网络请求的接口域名； - uploadFile 合法域名：上传图片/文件的域名； - downloadFile 合法域名：下载文件的域名； - socket 合法域名：使用 WebSocket 时配置； - 域名要求：必须是 HTTPS 开头，不能带端口号（除 443）、不能用 IP、不能用localhost。
每个类目通常可配置多个域名，配置后约数小时内生效，开发者工具可勾选"不校验合法域名"临时调试，但正式版必须配好。
实施步骤
- 注册域名：在正规注册商购买，所有人信息与备案主体一致。
- 解析到服务器：配置 A 记录或 CNAME，确认解析生效。
- 完成 ICP 备案：在服务器接入商处提交备案，等待管局审核通过。
- 部署 HTTPS：给域名配置 SSL 证书（详见 SSL 证书相关文章）。
- 后台加白名单：在小程序后台开发设置中，把接口域名加入 request 等合法域名列表。
- 真机验证：用真机预览版测试请求是否正常，不再报域名错误。
注意事项
- 主体一致：域名所有人、备案主体、小程序主体三者信息要一致，否则后续变更很麻烦。
- 必须 HTTPS：正式版小程序只认 HTTPS 域名，HTTP 域名无法通过白名单校验。
- 别用 IP 或带端口：白名单不支持直接填 IP 地址和非 443 端口，要用标准域名。
- 备案期间别对外：备案未完成前，小程序不能正式提供服务，可用体验版内部测试。
总结
小程序域名配置看似琐碎，其实是一条清晰的链路：注册域名 → 解析到服务器 → 完成 ICP 备案 → 部署 HTTPS → 后台加白名单。把这条链路按顺序走通，真机请求报错的问题基本就能解决。关键是提前把域名买好、备案周期留足，不要等到开发收尾才想起域名还没备案，否则容易耽误上线时间。
