RestTemplate配置PK12证书遇构造函数匹配错误（HttpClient5.x）

问题根源 #

Spring旧版本的HttpComponentsClientHttpRequestFactory仅兼容Apache HttpClient 4.x，而你使用的5.x版本中，HttpClient核心类的路径（org.apache.hc.client5.http.impl.classic.CloseableHttpClient）与4.x（org.apache.http.impl.client.CloseableHttpClient）完全不同，导致构造方法匹配失败。

解决步骤 #

1. 确认依赖版本 #

确保项目引入Spring Framework 5.3+（该版本开始原生支持HttpClient 5.x），同时引入HttpClient 5.x核心依赖：

<!-- Maven依赖示例 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>5.3.20</version> <!-- 或更高稳定兼容版本 -->
</dependency>
<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
    <version>5.2.1</version> <!-- 或最新稳定版 -->
</dependency>

注意：禁止同时引入HttpClient 4.x依赖，避免类路径冲突。

2. 编写正确的RestTemplate创建方法 #

基于HttpClient 5.x API构建带SSL证书的CloseableHttpClient，再传入Spring适配的HttpComponentsClientHttpRequestFactory：

import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;
import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.client5.http.ssl.SSLConnectionSocketFactory;
import org.apache.hc.core5.ssl.SSLContexts;

import javax.net.ssl.SSLContext;
import java.io.FileInputStream;
import java.security.KeyStore;

public RestTemplate createRestTemplateWithSSL() throws Exception {
    // 1. 加载SSL证书密钥库（示例为JKS格式，按需调整）
    KeyStore keyStore = KeyStore.getInstance("JKS");
    try (FileInputStream instream = new FileInputStream("path/to/your/keystore.jks")) {
        keyStore.load(instream, "keystore-password".toCharArray());
    }

    // 2. 构建SSLContext
    SSLContext sslContext = SSLContexts.custom()
            .loadKeyMaterial(keyStore, "key-password".toCharArray())
            .build();

    // 3. 创建HttpClient5的CloseableHttpClient实例
    SSLConnectionSocketFactory sslSocketFactory = new SSLConnectionSocketFactory(sslContext);
    CloseableHttpClient httpClient = HttpClients.custom()
            .setSSLSocketFactory(sslSocketFactory)
            .build();

    // 4. 适配Spring的HttpRequestFactory
    HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);

    // 5. 初始化RestTemplate
    RestTemplate restTemplate = new RestTemplate(requestFactory);
    return restTemplate;
}

3. 关键注意事项 #

• 不要直接使用InternalHttpClient，这是HttpClient5的内部实现类，应使用对外暴露的CloseableHttpClient接口实例。
• 若需信任自定义CA证书，在构建SSLContext时添加loadTrustMaterial逻辑即可。
• 保持Spring与HttpClient5版本的兼容性，避免类加载异常。

内容的提问来源于stack exchange，提问作者Tim's