升级Spring Boot3遇HttpClient类型转换及代码报错问题求助

问题根源 #

Spring Boot 3.x 默认依赖Apache HttpClient 5.x，而你的代码基于旧版HttpClient 4.x的API，两者包名、类结构差异极大，导致类型转换和类兼容性错误。

解决方案 #

1. 确认依赖正确性 #

确保项目依赖的是HttpClient5，Spring Boot 3的spring-boot-starter-web已默认引入httpclient5，若手动添加依赖需用：

<!-- Maven -->
<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
</dependency>

2. 适配HttpClient5的API重写代码 #

替换所有旧版API的导入，以下是修正后的完整代码示例：

import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClientBuilder;
import org.apache.hc.client5.http.impl.PoolingHttpClientConnectionManager;
import org.apache.hc.client5.http.ssl.SSLConnectionSocketFactory;
import org.apache.hc.core5.http.config.Registry;
import org.apache.hc.core5.http.config.RegistryBuilder;
import org.apache.hc.core5.http.io.ConnectionSocketFactory;
import org.apache.hc.core5.http.URIScheme;
import javax.net.ssl.SSLContext;

// 假设你已自定义好SSLContext，若无需自定义可直接用SSLContexts.createDefault()
SSLContext sslContext = ...;

// 创建连接套接字工厂注册器
Registry<ConnectionSocketFactory> socketRegistry = RegistryBuilder.<ConnectionSocketFactory>create()
        .register(URIScheme.HTTPS.getId(), new SSLConnectionSocketFactory(sslContext))
        // HttpClient5中替换原PlainConnectionSocketFactory的实现
        .register(URIScheme.HTTP.getId(), org.apache.hc.client5.http.impl.io.DefaultHttpClientConnectionSocketFactory.INSTANCE)
        .build();

// 构建连接池管理器
PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager(socketRegistry);
// 可按需配置连接池参数
connectionManager.setMaxTotal(100);
connectionManager.setDefaultMaxPerRoute(20);

// 最终构建HttpClient
CloseableHttpClient httpClient = HttpClientBuilder.create()
        .setConnectionManager(connectionManager)
        .disableRedirectHandling() // 保留原业务逻辑：禁用重定向
        .build();

关键差异点说明 #

• 包名变更：所有类从org.apache.http前缀改为org.apache.hc开头，务必导入正确的包
• 套接字工厂：旧版PlainConnectionSocketFactory替换为DefaultHttpClientConnectionSocketFactory.INSTANCE
• 类型对齐：使用CloseableHttpClient而非泛化的HttpClient，避免类型转换问题
• 简化场景：若无需自定义SSL和连接池，可直接简化代码：

CloseableHttpClient httpClient = HttpClientBuilder.create()
        .disableRedirectHandling()
        .build();

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