微信小程序域名要求有哪些？备案和https必须满足吗？
微信小程序域名要求
在微信小程序开发过程中,域名配置是确保小程序正常运行的关键环节，微信对小程序使用的域名有明确的技术和安全要求，开发者需严格遵守这些规范，以避免因域名不合规导致功能异常或审核失败，以下从域名基本要求、安全限制、配置流程及常见问题等方面，详细解析微信小程序的域名配置规则。
域名基本要求
微信小程序要求所有网络请求必须通过配置的合法域名发起,且域名需满足以下基础条件：
-
协议规范
域名必须使用https协议，微信小程序暂不支持http协议，开发者需确保服务器配置了有效的 SSL 证书，且证书颁发机构受信任，避免因证书问题（如过期、自签名证书）导致请求失败。 -
域名类型
仅支持常规域名，不支持 IP 地址、localhost 或局域网域名（如168.x.x），测试阶段可使用微信开发者工具的“不校验合法域名”选项，但正式上线前必须配置正式域名。 -
域名数量限制
每个小程序可配置最多20个合法域名（不同接口类型如 request、uploadFile、downloadFile 等共享此限制），若需配置更多域名，需通过微信公众平台提交申请，说明理由并审核通过。 -
域名层级要求
域名需完整配置，不支持通配符（如*.example.com），若需请求https://api.example.com/v1/data，则必须添加api.example.com而非仅example.com。
安全与合规限制
微信对小程序域名设置了严格的安全限制,以保障用户数据和平台生态安全，开发者需特别注意以下规则：
-
禁止未备案域名
中国大陆服务器部署的域名需完成 ICP 备案，且备案主体需与小程序主体一致，若使用海外服务器，无需 ICP 备案，但需确保域名符合当地法律法规。 -
限制
域名不得涉及违法违规内容，如赌博、色情、诈骗等，禁止使用未经授权的第三方域名（如未授权调用其他平台的接口）。 -
数据传输安全
涉及用户隐私数据（如身份证号、手机号）的接口，需使用加密传输（如 HTTPS + 数据加密算法），且域名需通过微信的“数据安全认证”。
-
跨域与重定向限制
小程序请求的域名不支持跨域资源共享（CORS）的 通配符，需明确指定允许的源域名，服务器端禁止通过 301/302 重定向跳转到非 HTTPS 域名，否则会导致请求失败。
域名配置流程
开发者需在微信公众平台完成域名配置,具体步骤如下：
-
登录微信公众平台
进入“开发”-“开发管理”-“开发设置”，找到“服务器域名”模块。 -
添加合法域名
在“request 合法域名”“uploadFile 合法域名”“downloadFile 合法域名”“WebSocket 合法域名”等输入框中，分别填写对应接口的 HTTPS 域名，每行一个域名，支持端口号（默认 443 可省略）。 -
提交审核
配置完成后，点击“提交审核”，微信团队将在 1-3 个工作日内完成审核，审核通过后方可生效，若审核未通过，需根据提示修改域名后重新提交。 -
开发者工具调试
在开发阶段，可在微信开发者工具的“详情”-“本地设置”中勾选“不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书”，临时跳过域名校验，但正式版本必须移除该选项。
常见问题与解决方案
-
提示“该域名未配置到小程序”
原因：域名未在微信公众平台配置，或配置后未通过审核。
解决：检查域名是否已添加至“服务器域名”并审核通过，确保域名协议为 HTTPS，且无拼写错误。 -
证书问题导致请求失败
原因：SSL 证书过期、自签名或颁发机构不受信任。
解决：更新证书为受信任机构（如 Let's Encrypt、DigiCert）签发的有效证书，确保证书链完整。 -
域名备案主体不一致
原因：小程序主体与域名备案主体不同。
解决：需完成域名备案主体变更，或使用与小程序主体一致的域名重新配置。
-
WebSocket 域名无法连接
原因：WebSocket 域名未单独配置，或服务器未支持 wss:// 协议。
解决：在“WebSocket 合法域名”中添加域名，并确保服务器使用wss://（而非ws://）协议。
最佳实践建议
-
域名规划与管理
合理规划域名数量，避免频繁修改，可按功能模块（如用户接口、支付接口、数据接口）分类配置，便于后期维护。 -
监控与维护
定期检查域名证书有效期，设置自动续期提醒，避免证书过期导致服务中断，监控域名可用性，确保接口稳定性。 -
测试与灰度发布
上线前通过测试环境充分验证域名配置，确保所有接口正常调用，可采用灰度发布策略，逐步开放给用户，降低风险。 -
合规性自查
定期检查域名内容是否符合微信平台规范，避免因违规内容导致小程序功能受限或封禁。
严格遵守微信小程序域名要求,是保障小程序稳定运行和用户体验的基础，开发者需充分理解相关规则，在开发初期就做好域名规划与配置，确保合规性，从而为小程序的顺利上线和长期运营奠定坚实基础。