在使用 网络 api 时,需要注意以下问题。
服务器域名白名单
使用 my.request、my.uploadfile 前,需要先配置服务器域名白名单。
- 自研小程序: 登录 > 进入小程序详情页面 > 开发 > 开发设置 > 服务器域名白名单
- 第三方应用: 登录 > 进入第三方应用详情页面 > 开发设置 > 服务器域名白名单
在小程序开发过程中,可在小程序开发者工具(ide)配置忽略域名合法性检查,如果选择忽略,则在开发者工具中不会校验域名合法性。
- 小程序开发者工具: 右上角 详情 > 域名信息 > 忽略 http 请求域名合法性检查
注意:
- 在开发者工具中配置的忽略域名合法性检查,仅对开发阶段生效,若小程序上线,请务必先在开放平台上配置 服务器域名白名单 。
- 在控制台中修改关于 服务器域名白名单 的配置后,只对之后构建和发布的小程序版本生效,已上线的版本使用的是修改前的域名配置。
https 证书
小程序必须使用 https/wss 发起网络请求。请求时系统会对服务器域名使用的 https 证书进行校验,如果校验失败,则请求不能成功发起。
如何检查
打开url: ,输入需要检查的域名,若看到两个 missing 说明是证书链不完整,如图:
如何解决
服务器需要追加部署以上缺失的2个证书链。
1)如果使用阿里云的服务器,可以参考:
2)非阿里云服务器需要联系相应的云服务器提供商或者相应的服务器运维工作人员。