Android API32使用Jitsi SDK 5.1.0连接会议报Failed to load config异常

在Android API 32设备上使用Jitsi SDK 5.1.0版本连接Jitsi官方公共服务器（非自行部署的私有服务器）会议时，抛出配置加载失败异常，核心报错为网络请求失败，无法拉取会议初始化必需的config.js配置文件。

异常堆栈信息 #

Failed to load config from https://meet.jit.si/config.js?room=<RoomName> Error(TypeError){"message":"Network request failed","stack":"index.android.bundle:116:8201\nindex.android.bundle:603:498\nvalue@index.android.bundle:29:1293\nvalue@index.android.bundle:45:3557\nindex.android.bundle:45:674\nvalue@index.android.bundle:45:2504\nvalue@index.android.bundle:45:646\nvalue@[native code]"}

现有接入配置代码 #

JitsiMeetConferenceOptions.Builder optionsBuilder =
                new JitsiMeetConferenceOptions.Builder()
                        .setRoom(confCode)
                        .setVideoMuted(true)
                        .setAudioMuted(true)
                        .setAudioOnly(false)
                        .setFeatureFlag("welcomepage.enabled", false)
                        .setUserInfo(userInfo);
JitsiMeetActivity.launch(this, optionsBuilder);

排查解决方向 #

• 基础网络连通性校验：在测试设备的系统浏览器中直接访问https://meet.jit.si/config.js地址，确认是否能正常返回JS脚本内容。如果浏览器端也无法访问，属于当前网络环境对Jitsi官方服务器存在访问限制，常见于内网策略拦截、运营商网络限制、区域访问限制场景，切换可正常访问该地址的网络即可复现验证。
• 应用权限与网络安全配置校验：Android API 32对应Android 12/12L系统，首先确认AndroidManifest.xml中已声明必需的网络权限：<uses-permission android:name="android.permission.INTERNET" />；其次检查应用的网络安全配置，若自定义了networkSecurityConfig规则，确认没有错误拦截Jitsi官方域名的HTTPS请求、没有配置不兼容的证书校验策略导致请求被系统拦截。
• SDK版本兼容性校验：Jitsi SDK 5.1.0属于较早发布的版本，Jitsi官方公共服务器会持续迭代更新，不会长期保留对过旧SDK版本的兼容支持，新旧版本接口格式、请求规则不匹配时也会直接抛出网络类错误。可升级至当前最新稳定版Jitsi SDK后重新测试，旧版本SDK对接迭代后的官方服务端无兼容性保障。
• 入参合法性校验：检查传入setRoom()方法的confCode参数，确认参数非空、不包含未转义的特殊字符、没有拼接多余的URL路径片段。异常信息中请求URL的room参数显示为<RoomName>占位符，若参数传值异常会导致请求路径非法，直接触发请求失败。
• 系统WebView环境校验：Jitsi SDK内部依赖Android系统WebView渲染会议页面，确认设备上的系统WebView为启用状态、已升级到近期维护的版本，没有开启全局广告拦截、资源拦截类规则拦截config.js这类静态资源的加载。

内容的提问来源于stack exchange，提问作者Krishnan V S