如何解决“fail:url not in domain list”错误?
问题描述
再集成小程序SDK项目时,小程序入会画面黑屏,不显示正确的画面内容,结合日志的数据,有类似如下的错误:
15 967: 2023-6-9 15:37:15 [log] [socket] WS onError ("errMsg":"fail:url not in domain list")
一般来说,出现这个问题的原因是微信小程序需要在微信后台配置socket和request的域名白名单,才可以再小程序中发起request和socket的连接,否则微信小程序会直接拦截请求,导致功能异常。
详见微信小程序网络文档说明;
解决方式
遇到此问题,常见的解决方式有两种:
正式方案
参见小程序SDK的准备工作,检查并确认所有开关和配置已经完成,重启小程序并入会测试;
临时方案
注意
此方案仅适用于开发调试阶段,临时关闭域名的校验,正式上线后,请按照正式方案解决;
在微信开发者工具中,可以临时开启 开发环境不校验请求域名、TLS版本及HTTPS证书
选项,跳过服务器域名的校验。
此时,在微信开发者工具中及手机开启调试模式(VConsole)
时,不会进行服务器域名的校验。
其他问题
如果手机上出现 “打开调试模式可以发出请求,关闭调试模式无法发出请求” 的现象,请确认是否跳过了域名校验、检查准备工作内容、并确认服务器域名和证书配置是否正确;