小程序开发者在本地模拟器里一切正常，一到真机或正式版就「请求失败」，九成问题出在网络配置上。微信对小程序的网络请求有三条硬性要求，上线前逐项检查，能避免上线当天的手忙脚乱。

第一条：请求域名必须 HTTPS

wx.request 只允许发起 HTTPS 请求，且证书必须是受信任的CA签发，自签名证书会被直接拒绝。用浏览器访问你的接口地址，确认地址栏是锁形图标且无证书告警。证书链不完整是常见坑，用 SSL 检测工具跑一次，补全中间证书。

第二条：域名要在后台配置白名单

在小程序管理后台「开发管理-开发设置-服务器域名」中，把 request、uploadFile、downloadFile 用到的域名逐一加入合法域名列表。注意三点：域名必须经过ICP备案、不能使用IP地址和端口（443除外）、每月可修改次数有限。开发阶段可以勾选「不校验合法域名」调试，但上线前务必按正式环境配置走一遍真机验证。

第三条：超时与并发控制

小程序默认请求超时60秒，但用户体验上超过3秒就该有加载提示。常见超时原因包括：接口未开启gzip压缩、单次返回数据量过大、服务器在境外或线路不稳。建议：

• 列表接口做分页，单页数据控制在几十KB以内；
• 图片走CDN并压缩，不要直接回源站拉原图；
• 对非关键请求做失败重试与静默降级，避免白屏。

上线前自查清单

• 所有接口均为HTTPS且证书链完整；
• 合法域名白名单与代码中的域名完全一致（含子域名）；
• 真机（安卓+iPhone各一台）跑通核心流程；
• 弱网测试：切换到4G弱网环境，确认有加载态与失败提示；
• 检查是否有写死的测试环境地址残留。

结语

小程序的网络问题大多在配置层，不在代码层。把上面这张清单在提审前过一遍，基本可以避开「上线即失败」的尴尬。如果团队没有专职运维，也可以把服务器与证书配置交给建站服务商一并托管，省心且出问题时有人兜底。