小程序服务器域名怎么配

一句话：小程序^释小程序微信小程序是运行在微信内的应用形态，由微信提供运行环境和开放接口。用户无需下载安装，通过搜索、扫码、分享或公众号入口打开。运行在微信的沙箱里，网络请求只认你在后台登记过的域名^释域名云服务器是可按需租用的虚拟计算资源；域名是网站的访问地址；带宽决定单位时间内能传输的数据量。三者构成网站运行的基础资源。。三类域名要分别配：request（接口^释接口API（Application Programming Interface，应用程序编程接口）是系统之间约定好的调用方式：调用方按约定传入参数，服务方返回结果。它是软件之间协作的接口。）、uploadFile/downloadFile（文件）、socket（长连接）。

配置步骤

1. 准备域名用独立子域（如 api.example.com），完成 ICP 备案，配好 HTTPS 证书。
2. 验证证书链用在线工具或 openssl s_client 检查，必须包含中间证书，否则部分安卓机会握手失败。
3. 后台登记小程序后台「开发 → 开发管理 → 开发设置 → 服务器域名」，按类别添加，保存后即时生效。
4. 真机验证用真机预览或体验版走一遍所有接口，开发者工具可勾选「不校验合法域名」，容易掩盖问题。

注意：开发者工具里关掉域名校验后一切正常，真机全挂，是最常见的上线事故。提审前必须用真机、且在关闭「不校验域名」的情况下完整走一遍。

硬性要求

• 协议：只支持 https / wss，不支持 http。
• 不能是 IP：必须用域名，不能用 IP 地址或 localhost。
• 不能带端口：默认 443，写非标端口会被拒绝。
• 备案：域名须已完成 ICP 备案。
• 修改次数：域名配置每月有修改次数限制，规划好再改，别反复试。

常见故障

• request:fail url not in domain list：域名没配或配错类别（把接口配到了 downloadFile）。
• 证书错误：证书过期、域名不匹配、缺中间证书。
• 部分机型失败：TLS 版本过低或加密套件不兼容，检查服务端配置。
• 上线后突然全挂：证书到期未续，或域名被拦截。

资料来源

• 微信开放文档《服务器域名配置》：域名要求、类别与修改限制。
• 微信开放文档《网络请求》：wx.request 的域名校验规则。
• CA/Browser Forum：证书链完整性要求。