问题现象

在微信开发者工具或真机体验版/正式版中打开小程序后，页面长时间白屏无响应、数据无法加载，或提示 request:fail url not in domain list。

---

根本原因与排查步骤

检查微信公众平台【服务器域名（合法域名）】配置（核心原因）

微信小程序强制要求所有网络请求必须发送至预先在微信公众平台白名单中报备的 HTTPS 域名。

1. 登录 微信公众平台 -> 进入【开发管理】 -> 【开发设置】 -> 【服务器域名】。
2. 检查并添加以下四项配置（填写你的商城主域名，必须以 https:// 或 wss:// 开头，不带端口与斜杠）：
   • request 合法域名：https://你的域名
   • socket 合法域名：wss://你的域名
   • uploadFile 合法域名：https://你的域名（若使用云存储，还需加入 OSS/COS 域名）
   • downloadFile 合法域名：https://你的域名（若使用云存储，还需加入 OSS/COS 域名）
3. 保存后重新打开小程序。

---

检查服务器 SSL 证书与 TLS 版本

• 微信官方安全规范：微信接口强制要求服务器 SSL 证书链完整，且必须支持 TLS 1.2 及以上协议。
• 排查：在各大 SSL 检查工具（如 MySSL）中输入域名进行测试，若证书存在中级证书缺失或 TLS 1.0 弱加密，需在 Nginx 中重新配置完整的 fullchain 证书并启用现代 TLS 协议。

---

开发工具临时排查手段

在微信开发者工具中进行本地调试时，可临时在右上角【详情】 -> 【本地设置】中勾选 “不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书”；若勾选后可正常加载，说明问题必为上述第 1 或第 2 点所致。