常见 SSL 错误处理：javax.net.ssl.SSLException 等异常的处理策略

做 Android 网络开发，最让人头疼的莫过于 SSL 相关的异常了。我记得刚入行那会儿，一看到 javax.net.ssl.SSLException 就头皮发麻。后来踩的坑多了，慢慢就摸清了门道。说白了，SSL 异常就那么几类，搞懂了它们的脾气，处理起来就顺手多了。

SSLException 的常见类型

我习惯把 SSL 异常分成三大类。你想想看，每次握手失败，无非就是证书有问题、协议版本不匹配、或者密码套件不对路。

异常类型	典型错误信息	常见原因
证书验证失败	javax.net.ssl.SSLHandshakeException: java.security.cert.CertPathValidatorException	证书过期、自签名、域名不匹配
协议版本不兼容	javax.net.ssl.SSLException: SSL handshake aborted	服务端只支持 TLS 1.2，客户端只支持 TLS 1.0
密码套件不匹配	javax.net.ssl.SSLException: No appropriate protocol	双方没有共同支持的加密算法
主机名验证失败	javax.net.ssl.SSLException: Hostname 'xxx' not verified	证书中的 CN/SAN 与请求域名不一致

核心处理策略

遇到 SSL 异常，我的第一反应不是去改代码，而是先抓包看日志。嗯，这里要注意，SSLException 的 getMessage() 方法往往能直接告诉你问题出在哪。

1. 证书验证失败的处理

我在项目中遇到过最典型的情况：测试环境用的自签名证书，结果上线前忘了替换。客户端直接崩了。正确的做法是分环境处理。

// 生产环境：严格验证
val trustManagerFactory = TrustManagerFactory.getInstance(
    TrustManagerFactory.getDefaultAlgorithm()
)
trustManagerFactory.init(null as KeyStore?)

// 测试环境：宽松验证（仅用于 debug 构建）
if (BuildConfig.DEBUG) {
    val trustAllCerts = arrayOf<TrustManager>(object : X509TrustManager {
        override fun checkClientTrusted(chain: Array<X509Certificate>, authType: String) {}
        override fun checkServerTrusted(chain: Array<X509Certificate>, authType: String) {}
        override fun getAcceptedIssuers(): Array<X509Certificate> = arrayOf()
    })
    // 仅在 debug 模式下使用
}

2. 协议版本不兼容的处理

Android 4.x 的设备默认只支持 TLS 1.0，但很多新服务端已经禁用了这个版本。怎么办？我建议在代码里显式指定支持的协议版本。

val sslContext = SSLContext.getInstance("TLS")
sslContext.init(null, trustManagerFactory.trustManagers, SecureRandom())

val socketFactory = sslContext.socketFactory as SSLSocketFactory
// 创建一个包装类，限制只使用 TLS 1.2
val wrappedFactory = object : SSLSocketFactory() {
    override fun createSocket(s: Socket, host: String, port: Int, autoClose: Boolean): Socket {
        val socket = socketFactory.createSocket(s, host, port, autoClose) as SSLSocket
        socket.enabledProtocols = arrayOf("TLSv1.2", "TLSv1.3")
        return socket
    }
    // 其他方法委托给 socketFactory
}

异常捕获与重试机制

光捕获异常还不够，你得知道怎么优雅地恢复。我个人习惯用这样的策略：

1. 区分异常类型：证书错误通常不可恢复，直接提示用户；网络抖动导致的握手失败可以重试。
2. 指数退避重试：第一次失败等 1 秒，第二次等 2 秒，第三次等 4 秒，最多重试 3 次。
3. 记录详细日志：把异常堆栈、证书指纹、协议版本都记下来，方便排查。

fun executeWithRetry(url: String, maxRetries: Int = 3) {
    var retryCount = 0
    var delay = 1000L

    while (retryCount < maxRetries) {
        try {
            // 执行网络请求
            val response = httpClient.newCall(Request.Builder().url(url).build()).execute()
            // 成功则返回
            return
        } catch (e: SSLHandshakeException) {
            // 证书问题，不重试
            Log.e("SSL", "Certificate error: ${e.message}")
            throw e
        } catch (e: SSLException) {
            // 其他 SSL 错误，可以重试
            retryCount++
            if (retryCount < maxRetries) {
                Log.w("SSL", "Retry $retryCount after ${delay}ms")
                Thread.sleep(delay)
                delay *= 2
            } else {
                throw e
            }
        }
    }
}

知识体系总览

下面这张图是我整理出来的 SSL 异常处理全景。你可以把它当成一个检查清单，遇到问题按图索骥就行。

避坑指南

最后分享几个我踩过的坑，希望能帮你少走弯路。

嗯，SSL 异常处理说白了就是「该严的时候严，该松的时候松」。生产环境一丝不苟，调试环境灵活变通。掌握了这个度，你就能写出既安全又好用的网络层。

---

公众号:蓝海资料掘金营，微信 deep3321