升级HttpClient4至5后遇org.apache.http.client.HttpClient无法解析问题求助

问题根源 #

Spring 默认的 HttpComponentsClientHttpRequestFactory 是为 HttpClient 4.x 设计的，它依赖的是 org.apache.http.client.HttpClient 类型。而 HttpClient 5.x 的核心客户端类路径已变更为 org.apache.hc.client5.http.classic.HttpClient，两者类型不兼容，导致调用 setHttpClient 时出现编译错误。

解决步骤 #

1. 确认Spring版本：确保你的Spring Framework版本在5.3及以上（Spring 5.3开始提供HttpClient5的适配类）。
2. 替换请求工厂类：将原来的 HttpComponentsClientHttpRequestFactory 替换为Spring提供的HttpClient5专属适配类 org.springframework.http.client.HttpComponentsClient5HttpRequestFactory。
3. 修改代码示例：

org.apache.hc.client5.http.classic.HttpClient client = org.apache.hc.client5.http.impl.classic.HttpClients.custom()
        .setConnectionManager(connectionManager)
        .build(); 
final org.springframework.http.client.HttpComponentsClient5HttpRequestFactory requestFactory = new HttpComponentsClient5HttpRequestFactory();
requestFactory.setHttpClient(client);
// 后续将requestFactory绑定到RestTemplate
RestTemplate restTemplate = new RestTemplate(requestFactory);

补充说明 #

如果你的Spring版本无法升级到5.3+，可尝试寻找第三方兼容包，但官方推荐的最优方案是升级Spring版本并使用官方适配类，避免潜在的兼容性问题。

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