Spring Boot 3中RestTemplate调用HTTPS URL编译报错求助

在Spring Boot 3中配置RestTemplate调用HTTPS URL时代码无法编译，使用了org.apache.http.impl.client.HttpClients、org.apache.http.ssl.SSLContexts，代码如下：

fun restTemplate(): RestTemplate {
        val restTemplate = RestTemplate()

        // Load the .p12 file from the test resources directory
        val p12File = ClassPathResource("certs/clientErfin2.p12").file
        val p12Stream = FileInputStream(p12File)

        try {
            // Load the .p12 file into a KeyStore
            val keyStore = KeyStore.getInstance("PKCS12")
            keyStore.load(p12Stream, "password".toCharArray())

            // Create an SSL context with the KeyStore
            val sslContext = SSLContexts.custom()
                    .loadKeyMaterial(keyStore, "password".toCharArray())
                    .build()

            // Create an HttpClient with the SSL context
            val httpClient = HttpClients.custom()
                    .setSSLContext(sslContext)
                    .build()

            // Create a ClientHttpRequestFactory with the HttpClient
            val requestFactory: ClientHttpRequestFactory = HttpComponentsClientHttpRequestFactory(httpClient)

            // Set the ClientHttpRequestFactory on the RestTemplate
            restTemplate.requestFactory = requestFactory
        } finally {
            p12Stream.close()
        }

        return restTemplate
    }

编译失败行：val requestFactory: ClientHttpRequestFactory = HttpComponentsClientHttpRequestFactory(httpClient)，报错信息：

Cannot access class 'org.apache.hc.client5.http.classic.HttpClient'. Check your module classpath for missing or conflicting dependencies

尝试添加hc.client5依赖后问题仍未解决，求修复方法。

问题根源是Spring Boot 3默认适配Apache HttpClient 5，但代码混用了HttpClient 4和5的API，同时依赖配置可能不完整或版本不匹配。按以下步骤修复：

1. 配置正确的依赖 #

引入Spring Boot官方适配的HttpClient5 starter依赖，避免版本冲突：

• Maven配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-httpclient</artifactId>
</dependency>

• Gradle（Kotlin DSL）配置：

implementation("org.springframework.boot:spring-boot-starter-httpclient")

2. 替换API导入与代码适配 #

HttpClient 5的API包名从org.apache.http调整为org.apache.hc，需替换所有相关导入并调整代码：

• 替换导入语句：

  // 移除原HttpClient 4的导入
  // import org.apache.http.impl.client.HttpClients
  // import org.apache.http.ssl.SSLContexts
  
  // 添加HttpClient 5的导入
  import org.apache.hc.client5.http.impl.classic.HttpClients
  import org.apache.hc.core5.ssl.SSLContexts
  

• 修正后的RestTemplate配置代码：

  fun restTemplate(): RestTemplate {
      val restTemplate = RestTemplate()
  
      val p12File = ClassPathResource("certs/clientErfin2.p12").file
      val p12Stream = FileInputStream(p12File)
  
      try {
          val keyStore = KeyStore.getInstance("PKCS12")
          keyStore.load(p12Stream, "password".toCharArray())
  
          // 使用HttpClient 5的SSLContexts构建SSL上下文
          val sslContext = SSLContexts.custom()
              .loadKeyMaterial(keyStore, "password".toCharArray())
              .build()
  
          // 构建HttpClient 5实例
          val httpClient = HttpClients.custom()
              .setSSLContext(sslContext)
              .build()
  
          // 绑定适配HttpClient5的请求工厂
          val requestFactory = HttpComponentsClientHttpRequestFactory(httpClient)
          restTemplate.requestFactory = requestFactory
      } finally {
          p12Stream.close()
      }
  
      return restTemplate
  }
  

3. 排查依赖冲突 #

检查项目依赖树，确保没有同时引入HttpClient 4的依赖：

• Maven：执行mvn dependency:tree，若发现org.apache.httpcomponents:httpclient（HttpClient4）依赖，需在对应依赖中添加排除配置。
• Gradle：执行./gradlew dependencies，排查并排除冲突的HttpClient4依赖。

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