服务器测评网
我们一直在努力

微信小程序域名要求有哪些?备案和https必须满足吗?

微信小程序域名要求

在微信小程序开发过程中,域名配置是确保小程序正常运行的关键环节,微信对小程序使用的域名有明确的技术和安全要求,开发者需严格遵守这些规范,以避免因域名不合规导致功能异常或审核失败,以下从域名基本要求、安全限制、配置流程及常见问题等方面,详细解析微信小程序的域名配置规则。

微信小程序域名要求有哪些?备案和https必须满足吗?

域名基本要求

微信小程序要求所有网络请求必须通过配置的合法域名发起,且域名需满足以下基础条件:

  1. 协议规范
    域名必须使用 https 协议,微信小程序暂不支持 http 协议,开发者需确保服务器配置了有效的 SSL 证书,且证书颁发机构受信任,避免因证书问题(如过期、自签名证书)导致请求失败。

  2. 域名类型
    仅支持常规域名,不支持 IP 地址、localhost 或局域网域名(如 168.x.x),测试阶段可使用微信开发者工具的“不校验合法域名”选项,但正式上线前必须配置正式域名。

  3. 域名数量限制
    每个小程序可配置最多20个合法域名(不同接口类型如 request、uploadFile、downloadFile 等共享此限制),若需配置更多域名,需通过微信公众平台提交申请,说明理由并审核通过。

  4. 域名层级要求
    域名需完整配置,不支持通配符(如 *.example.com),若需请求 https://api.example.com/v1/data,则必须添加 api.example.com 而非仅 example.com

安全与合规限制

微信对小程序域名设置了严格的安全限制,以保障用户数据和平台生态安全,开发者需特别注意以下规则:

  1. 禁止未备案域名
    中国大陆服务器部署的域名需完成 ICP 备案,且备案主体需与小程序主体一致,若使用海外服务器,无需 ICP 备案,但需确保域名符合当地法律法规。

  2. 限制
    域名不得涉及违法违规内容,如赌博、色情、诈骗等,禁止使用未经授权的第三方域名(如未授权调用其他平台的接口)。

  3. 数据传输安全
    涉及用户隐私数据(如身份证号、手机号)的接口,需使用加密传输(如 HTTPS + 数据加密算法),且域名需通过微信的“数据安全认证”。

    微信小程序域名要求有哪些?备案和https必须满足吗?

  4. 跨域与重定向限制
    小程序请求的域名不支持跨域资源共享(CORS)的 通配符,需明确指定允许的源域名,服务器端禁止通过 301/302 重定向跳转到非 HTTPS 域名,否则会导致请求失败。

域名配置流程

开发者需在微信公众平台完成域名配置,具体步骤如下:

  1. 登录微信公众平台
    进入“开发”-“开发管理”-“开发设置”,找到“服务器域名”模块。

  2. 添加合法域名
    在“request 合法域名”“uploadFile 合法域名”“downloadFile 合法域名”“WebSocket 合法域名”等输入框中,分别填写对应接口的 HTTPS 域名,每行一个域名,支持端口号(默认 443 可省略)。

  3. 提交审核
    配置完成后,点击“提交审核”,微信团队将在 1-3 个工作日内完成审核,审核通过后方可生效,若审核未通过,需根据提示修改域名后重新提交。

  4. 开发者工具调试
    在开发阶段,可在微信开发者工具的“详情”-“本地设置”中勾选“不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书”,临时跳过域名校验,但正式版本必须移除该选项。

常见问题与解决方案

  1. 提示“该域名未配置到小程序”
    原因:域名未在微信公众平台配置,或配置后未通过审核。
    解决:检查域名是否已添加至“服务器域名”并审核通过,确保域名协议为 HTTPS,且无拼写错误。

  2. 证书问题导致请求失败
    原因:SSL 证书过期、自签名或颁发机构不受信任。
    解决:更新证书为受信任机构(如 Let’s Encrypt、DigiCert)签发的有效证书,确保证书链完整。

  3. 域名备案主体不一致
    原因:小程序主体与域名备案主体不同。
    解决:需完成域名备案主体变更,或使用与小程序主体一致的域名重新配置。

    微信小程序域名要求有哪些?备案和https必须满足吗?

  4. WebSocket 域名无法连接
    原因:WebSocket 域名未单独配置,或服务器未支持 wss:// 协议。
    解决:在“WebSocket 合法域名”中添加域名,并确保服务器使用 wss://(而非 ws://)协议。

最佳实践建议

  1. 域名规划与管理
    合理规划域名数量,避免频繁修改,可按功能模块(如用户接口、支付接口、数据接口)分类配置,便于后期维护。

  2. 监控与维护
    定期检查域名证书有效期,设置自动续期提醒,避免证书过期导致服务中断,监控域名可用性,确保接口稳定性。

  3. 测试与灰度发布
    上线前通过测试环境充分验证域名配置,确保所有接口正常调用,可采用灰度发布策略,逐步开放给用户,降低风险。

  4. 合规性自查
    定期检查域名内容是否符合微信平台规范,避免因违规内容导致小程序功能受限或封禁。

严格遵守微信小程序域名要求,是保障小程序稳定运行和用户体验的基础,开发者需充分理解相关规则,在开发初期就做好域名规划与配置,确保合规性,从而为小程序的顺利上线和长期运营奠定坚实基础。

赞(0)
未经允许不得转载:好主机测评网 » 微信小程序域名要求有哪些?备案和https必须满足吗?