问题原因 #

在HttpClient 5中，连接管理器的配置逻辑做了重构，PoolingHttpClientConnectionManager不再提供setDefaultSocketFactory方法来动态设置套接字工厂。新版本的设计更强调初始化阶段的配置，我们需要通过连接套接字工厂注册表（ConnectionSocketFactoryRegistry）来注册SSL工厂，或者使用HttpClients.custom()的便捷API直接绑定SSL配置，这样既符合新版本的设计规范，也能简化代码。

修复后的完整迁移代码 #

下面是调整后的正确代码，我会标注关键的修改点：

import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManager;
import org.apache.hc.client5.http.socket.ConnectionSocketFactoryRegistryBuilder;
import org.apache.hc.client5.http.socket.PlainConnectionSocketFactory;
import org.apache.hc.client5.http.ssl.SSLConnectionSocketFactory;
import org.apache.hc.core5.ssl.SSLContextBuilder;
import org.springframework.web.client.RestTemplate;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import javax.net.ssl.SSLContext;
import java.io.InputStream;
import java.security.KeyStore;

// 保留你的pkcsKeyStore辅助方法不变
private KeyStore pkcsKeyStore(String file, char... password) throws Exception {
    KeyStore keyStore = KeyStore.getInstance("PKCS12");
    try (InputStream in = this.getClass().getClassLoader().getResourceAsStream(file)) {
        keyStore.load(in, password);
    }
    return keyStore;
}

@Bean(name = "sslRestTemplateBean")
public RestTemplate sslRestTemplate() throws Exception {
    char[] unlockPhrase = "test".toCharArray();
    SSLContext sslContext = SSLContextBuilder.create()
            .loadKeyMaterial(pkcsKeyStore("/key.p12", unlockPhrase), unlockPhrase)
            .build();

    // 1. 创建SSL连接套接字工厂
    SSLConnectionSocketFactory sslSocketFactory = new SSLConnectionSocketFactory(sslContext);

    // 2. 构建套接字工厂注册表：同时注册HTTP和HTTPS的工厂
    var socketFactoryRegistry = ConnectionSocketFactoryRegistryBuilder.create()
            .register("http", PlainConnectionSocketFactory.getSocketFactory())
            .register("https", sslSocketFactory)
            .build();

    // 3. 用注册表初始化连接管理器（这是HttpClient5的标准方式）
    PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager(socketFactoryRegistry);

    // 4. 构建最终的CloseableHttpClient
    CloseableHttpClient client = HttpClients.custom()
            .setConnectionManager(connectionManager)
            .build();

    return new RestTemplate(new HttpComponentsClientHttpRequestFactory(client));
}

static RestTemplate createSslRestTemplate(SslCertificate sslCertificate) throws Exception {
    char[] password = generateRandomString().toCharArray();
    SSLContext sslContext = SSLContextBuilder.create()
            .loadKeyMaterial(keyStore(sslCertificate, password), password)
            .build();

    // 简化配置：直接用HttpClientBuilder的便捷API，无需手动创建连接管理器
    SSLConnectionSocketFactory sslSocketFactory = new SSLConnectionSocketFactory(sslContext);
    CloseableHttpClient client = HttpClients.custom()
            .disableAutomaticRetries()
            .setSSLSocketFactory(sslSocketFactory) // 自动处理连接管理器的SSL配置
            .build();

    return new RestTemplate(new HttpComponentsClientHttpRequestFactory(client));
}

关键修改点说明 #

1. 连接管理器初始化逻辑：
   必须通过ConnectionSocketFactoryRegistryBuilder创建包含HTTP、HTTPS套接字工厂的注册表，再传入PoolingHttpClientConnectionManager的构造方法，这是HttpClient5要求的标准配置流程。
2. 简化配置的替代方案：
   如果你不需要自定义连接池的参数（比如最大连接数、超时时间），可以直接使用HttpClients.custom().setSSLSocketFactory()，这个方法会自动帮你初始化带有SSL工厂的连接管理器，大幅简化代码（参考createSslRestTemplate方法）。
3. 依赖类的正确性：
   注意导入HttpClient5的正确包路径，比如PoolingHttpClientConnectionManager来自org.apache.hc.client5.http.impl.io，ConnectionSocketFactoryRegistryBuilder来自org.apache.hc.client5.http.socket。

额外注意事项 #

• 确保项目依赖中已正确引入HttpClient5的必要模块：httpclient5、httpcore5、httpclient5-ssl等，避免类找不到的问题。
• 若需要自定义连接池参数（如最大总连接数、单路由最大连接数），可在创建PoolingHttpClientConnectionManager后调用setMaxTotal()、setDefaultMaxPerRoute()等方法配置。

内容来源于stack exchange