Loading...

如何解决“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)​​时,不会进行服务器域名的校验。

其他问题

如果手机上出现 “打开调试模式可以发出请求,关闭调试模式无法发出请求” 的现象,请确认是否跳过了域名校验、检查​​准备工作​​内容、并确认服务器域名和证书配置是否正确;

意见反馈