限制SSL/HTTPS访问时Google Map加载异常与SSL证书配置冲突

这个问题的核心原因很明确：你全局设置了默认的SSLSocketFactory，这会覆盖整个应用所有HTTPS请求的SSL配置——包括Google Maps SDK发起的地图资源请求。而Google Maps的服务器证书不在你raw文件夹的信任列表里，导致地图请求的SSL验证失败，但Maps SDK可能内部吞掉了错误，所以你看不到报错但地图加载不出来。

正确的做法是不要全局替换SSL配置，只给你自己的API请求（比如https://XXX.com/login）单独使用自定义证书验证。针对Volley，我们可以通过自定义HurlStack来实现这个需求，具体步骤如下：

1. 编写加载自定义证书的工具方法 #

先实现一个方法，从raw文件夹读取你的证书并创建专属的SSLSocketFactory：

private SSLSocketFactory getCustomSSLSocketFactory(Context context) {
    try {
        // 初始化证书工厂，读取raw中的证书文件
        CertificateFactory certFactory = CertificateFactory.getInstance("X.509");
        InputStream certStream = context.getResources().openRawResource(R.raw.your_cert_file);
        Certificate trustedCert;
        try {
            trustedCert = certFactory.generateCertificate(certStream);
        } finally {
            certStream.close();
        }

        // 创建密钥库并添加信任证书
        KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
        keyStore.load(null, null);
        keyStore.setCertificateEntry("trusted_cert", trustedCert);

        // 初始化信任管理器工厂
        TrustManagerFactory trustManagerFactory = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
        trustManagerFactory.init(keyStore);

        // 创建自定义SSLContext并返回SocketFactory
        SSLContext sslContext = SSLContext.getInstance("TLS");
        sslContext.init(null, trustManagerFactory.getTrustManagers(), new SecureRandom());
        return sslContext.getSocketFactory();
    } catch (Exception e) {
        throw new RuntimeException("Failed to create custom SSL Socket Factory", e);
    }
}

2. 自定义Volley的HurlStack #

创建一个自定义的HurlStack，只在请求你的目标域名（XXX.com）时使用上面的自定义SSL配置，其他请求保持系统默认：

public class DomainSpecificSslHurlStack extends HurlStack {
    private final Context mAppContext;
    private final SSLSocketFactory mCustomSslSocketFactory;
    private static final String TARGET_DOMAIN = "XXX.com";

    public DomainSpecificSslHurlStack(Context context) {
        mAppContext = context.getApplicationContext();
        mCustomSslSocketFactory = getCustomSSLSocketFactory(mAppContext);
    }

    @Override
    protected HttpURLConnection createConnection(URL url) throws IOException {
        HttpURLConnection connection = super.createConnection(url);
        // 仅对目标域名应用自定义SSL配置
        if (TARGET_DOMAIN.equals(url.getHost())) {
            if (connection instanceof HttpsURLConnection) {
                ((HttpsURLConnection) connection).setSSLSocketFactory(mCustomSslSocketFactory);
            }
        }
        return connection;
    }

    // 把上面的getCustomSSLSocketFactory方法复制到这里，或者作为全局工具方法调用
    private SSLSocketFactory getCustomSSLSocketFactory(Context context) {
        // 此处粘贴工具方法代码
    }
}

3. 使用自定义HurlStack初始化Volley RequestQueue #

最后，在创建Volley请求队列时传入这个自定义的HurlStack：

RequestQueue volleyQueue = Volley.newRequestQueue(
    getApplicationContext(), 
    new DomainSpecificSslHurlStack(getApplicationContext())
);

为什么这样能解决问题？ #

• 你的https://XXX.com/login等API请求会使用自定义证书进行SSL验证，解决SSLHandshake Error；
• Google Maps的请求依然使用系统默认的SSL配置，能正常验证Google服务器的证书，所以地图可以正常加载。

补充几个注意点：

• 确保raw文件夹中的证书文件名和代码里的R.raw.your_cert_file一致；
• 如果你的API有多个子域名（比如api.XXX.com），需要调整TARGET_DOMAIN的判断逻辑；
• 建议在异常处理中添加日志，方便排查证书加载失败的问题。

内容的提问来源于stack exchange，提问作者Parth Kapoor