小程序服务器域名配置规则

小程序服务器域名配置规则如下：

一、域名格式要求

1. 域名+端口：允许配置，但必须严格匹配

   • 示例：api.example.com:8080
   • 要求：请求时必须使用相同端口，不同端口视为不同域名

2. 二级域名：必须单独配置

   • 示例：sub.example.com需单独配置，不会继承父域名权限

3. 二级域名+端口：需完整配置

   • 示例：sub.example.com:8443需作为独立条目配置

二、访问范围限制

• 仅允许访问精确配置的域名，不支持通配符

• 示例：配置api.example.com时：

  • ✅允许访问api.example.com
  • ❌不允许访问app.api.example.com或其他子域名

三、注意事项

1. 协议要求：必须使用HTTPS/WSS协议

2. 备案要求：域名需完成ICP备案（新备案需等待24小时生效）

3. 禁用内容：

   • 禁止使用IP地址（除局域网IP）
   • 禁止配置api.weixin.qq.com
   • 禁用localhost

4. 端口规则：

   • HTTPS必须配置完整端口号
   • WSS无需配置端口

5. 配置方式：每个域名条目需单独添加，不支持批量配置

四、企业账号特殊说明

企业类型小程序可正常使用上述配置方式，无额外限制。建议通过小程序后台的「开发管理-开发设置-服务器域名」进行配置后，通过getDomainInfo接口验证配置结果。

注意：若使用了web-view需配置备案过的https业务域名（个人主体微信小程序无法配置业务域名。根据微信官方规定，业务域名配置功能仅限‌企业主体认证的小程序‌，个人主体小程序因不具备网页内嵌能力，因此后台无相关设置入口）