Android中OkHttpClient适配HTTPS失败问题排查求助

嘿，我之前也碰到过一模一样的问题！浏览器能正常访问但应用连不上，大概率是配置细节出了问题，咱们一步步来排查：

1. 先检查最容易忽略的低级错误：BaseUrl格式 #

你代码里的baseUrl写的是"https:xyz.com/api/"——这里少了//！正确的HTTPS地址格式应该是"https://xyz.com/api/"。浏览器会自动补全这个格式错误，但Retrofit和OkHttpClient对URL格式要求很严格，这绝对是优先排查的点！

2. SSL证书信任问题（最常见的核心原因） #

浏览器自带了完整的根证书库，但Android应用的证书信任体系是独立的。如果目标服务器用的是自签名证书、内部CA颁发的证书，或者某些小众CA的证书，OkHttpClient默认会拒绝信任，直接断开连接。

临时调试方案（仅用于测试，生产环境绝对禁用！） #

可以临时跳过证书验证来确认是不是这个问题：

// 创建信任所有证书的SSLSocketFactory
private static SSLSocketFactory createUnsafeSSLSocketFactory() {
    try {
        final TrustManager[] trustAllCerts = new TrustManager[]{
            new X509TrustManager() {
                @Override
                public void checkClientTrusted(java.security.cert.X509Certificate[] chain, String authType) {}
                @Override
                public void checkServerTrusted(java.security.cert.X509Certificate[] chain, String authType) {}
                @Override
                public java.security.cert.X509Certificate[] getAcceptedIssuers() {
                    return new java.security.cert.X509Certificate[]{};
                }
            }
        };
        SSLContext sslContext = SSLContext.getInstance("SSL");
        sslContext.init(null, trustAllCerts, new java.security.SecureRandom());
        return sslContext.getSocketFactory();
    } catch (Exception e) {
        throw new RuntimeException(e);
    }
}

// 配置OkHttpClient
OkHttpClient okHttpClient = new OkHttpClient.Builder()
    .connectTimeout(4, TimeUnit.SECONDS)
    .sslSocketFactory(createUnsafeSSLSocketFactory(), (X509TrustManager) trustAllCerts[0])
    .hostnameVerifier((hostname, session) -> true) // 跳过主机名验证
    .build();

生产环境正确方案 #

把服务器的证书文件导入应用，配置OkHttpClient仅信任该证书，既安全又能解决连接问题。

3. TLS版本兼容性问题 #

有些老旧服务器只支持TLS 1.0/1.1，而OkHttpClient在Android 7.0+默认会禁用这些低版本协议。可以手动指定兼容的TLS版本：

OkHttpClient okHttpClient = new OkHttpClient.Builder()
    .connectTimeout(4, TimeUnit.SECONDS)
    .connectionSpecs(Arrays.asList(
        ConnectionSpec.MODERN_TLS,
        ConnectionSpec.COMPATIBLE_TLS // 兼容旧版本TLS协议
    ))
    .build();

4. 网络配置差异 #

• 浏览器可能使用了系统代理，但应用的网络设置未同步，可以尝试关闭手机代理再测试；
• 确认应用已经申请了INTERNET权限，没有被系统防火墙或安全软件拦截。

先从BaseUrl格式开始排查，这个最容易解决！如果改完还是不行，再依次检查证书和TLS的问题。

内容的提问来源于stack exchange，提问作者Jordy Voorham