Android端用Twilio Programmable Chat发图片消息遇SSL证书验证失败异常

这个SSL证书验证失败的异常我之前帮不少Android开发者排查过，大概率是证书信任配置、SDK版本或者网络环境的问题，咱们一步步来解决：

1. 先升级Twilio Programmable Chat SDK到最新版本 #

旧版本的SDK可能存在根证书过期或者信任配置不完善的问题，你可以在项目的build.gradle（Module级别）里更新依赖，比如把SDK版本替换成官方最新的：

dependencies {
    // 替换成最新的Twilio Chat SDK版本
    implementation 'com.twilio:chat:6.0.+'
}

更新后同步项目，再测试发送图片的场景。

2. 配置Android网络安全策略（针对Android 7.0+） #

Android 7.0及以上系统默认会严格验证SSL证书，如果你遇到证书信任问题，可以通过网络安全配置文件来明确信任Twilio的域名和系统根证书：

• 在res/xml目录下创建network_security_config.xml文件，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="false">
        <trust-anchors>
            <!-- 信任系统默认的根证书 -->
            <certificates src="system" />
        </trust-anchors>
    </base-config>
    <!-- 专门针对Twilio的通信域名做配置，确保证书验证正常 -->
    <domain-config cleartextTrafficPermitted="false">
        <domain includeSubdomains="true">twilio.com</domain>
        <domain includeSubdomains="true">twil.io</domain>
    </domain-config>
</network-security-config>

• 然后在AndroidManifest.xml的application标签里添加这个配置：

<application
    ...
    android:networkSecurityConfig="@xml/network_security_config">
    ...
</application>

3. 排查网络代理或VPN的影响 #

如果你测试时开启了代理服务器或者VPN，很可能会触发中间人攻击导致证书验证失败。建议先关闭所有代理和VPN，在纯净的网络环境下测试发送图片的功能，看看异常是否消失。

4. 检查文件访问权限和文件流的正确性 #

虽然异常是SSL相关，但也要确保你的APP有足够的文件访问权限：

• 针对Android 12及以下，需要在AndroidManifest.xml中添加READ_EXTERNAL_STORAGE权限；Android 13+则需要READ_MEDIA_IMAGES权限，并且要在运行时申请这些权限。
• 另外，检查你传入withMedia的FileInputStream是否正确打开，有没有在发送前被意外关闭，路径是否指向有效的图片文件。

5. 自定义OkHttpClient（针对部分SDK版本） #

如果上面的方法都没解决，你可以尝试为Twilio Chat SDK配置自定义的OkHttpClient，强制使用系统信任的证书库：

try {
    // 获取系统默认的信任管理器
    TrustManagerFactory trustManagerFactory = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
    trustManagerFactory.init((KeyStore) null);
    TrustManager[] trustManagers = trustManagerFactory.getTrustManagers();
    X509TrustManager x509TrustManager = (X509TrustManager) trustManagers[0];

    // 创建信任系统证书的SSLSocketFactory
    SSLContext sslContext = SSLContext.getInstance("TLS");
    sslContext.init(null, new TrustManager[]{x509TrustManager}, null);
    SSLSocketFactory sslSocketFactory = sslContext.getSocketFactory();

    // 构建自定义OkHttpClient
    OkHttpClient okHttpClient = new OkHttpClient.Builder()
            .sslSocketFactory(sslSocketFactory, x509TrustManager)
            .build();

    // 将自定义Client传入Twilio Chat配置
    ChatClient.Properties props = new ChatClient.Properties.Builder()
            .setOkHttpClient(okHttpClient)
            .build();

    // 初始化ChatClient时使用这个配置
    ChatClient.create(context, "YOUR_TWILIO_TOKEN", props, new ChatClientListener() {
        // 实现回调方法
        @Override
        public void onClientSynchronized() {
            // 初始化完成后的逻辑
        }

        // 其他必要的回调方法...
    });
} catch (NoSuchAlgorithmException | KeyStoreException | KeyManagementException e) {
    e.printStackTrace();
}

你可以根据自己的情况逐个尝试这些方案，大部分情况下升级SDK或者配置网络安全策略就能解决这个SSL验证失败的问题。

内容的提问来源于stack exchange，提问作者Anshul Mittal