Spring Boot 2.7.3升级3.0后RestTemplate配置问题求助

问题根源 #

Spring Boot 3.0 基于 Spring Framework 6.x 构建，同时默认将 Apache HttpClient 升级至 5.x 版本，导致原 4.x 版本的 HttpClient API 与新版 HttpComponentsClientHttpRequestFactory 不兼容，且部分超时设置方法被标记为废弃。

修复步骤 #

1. 替换依赖与导入包 #

确保项目引入 Spring Boot 3.0 提供的 spring-boot-starter-httpclient（默认包含 Apache HttpClient 5.x），并替换代码中的导入路径：

• 原 org.apache.http.conn.ssl.NoopHostnameVerifier → 替换为 org.apache.hc.client5.http.ssl.NoopHostnameVerifier
• 原 org.apache.http.impl.client.CloseableHttpClient → 替换为 org.apache.hc.client5.http.impl.classic.CloseableHttpClient
• 原 org.apache.http.impl.client.HttpClients → 替换为 org.apache.hc.client5.http.impl.classic.HttpClients

2. 解决setHttpClient参数不兼容问题 #

Apache HttpClient 5.x 中，CloseableHttpClient 实现了 org.apache.hc.client5.http.classic.HttpClient 接口，而新版 HttpComponentsClientHttpRequestFactory.setHttpClient() 恰好接受该接口类型，直接使用 5.x 的 CloseableHttpClient 实例即可适配。

3. 替换废弃的超时设置方法 #

原 setReadTimeout()、setConnectTimeout(int)、setConnectionRequestTimeout(int) 均已废弃，推荐通过 Apache HttpClient 5.x 的 RequestConfig 统一配置所有超时参数，再绑定到 HttpClient 实例中，更符合新版本的设计规范。

修改后的完整代码 #

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.NoopHostnameVerifier;
import org.apache.hc.client5.http.config.RequestConfig;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;

@Configuration
@Profile("dev")
public class RestTemplateConfigurationDev {

    private static final int TIMEOUT_MS = 30000;

    @Bean
    public RestTemplate getRestTemplate() {
        // 统一配置超时参数
        RequestConfig requestConfig = RequestConfig.custom()
                .setConnectTimeout(TIMEOUT_MS) // 连接超时
                .setResponseTimeout(TIMEOUT_MS) // 读取超时（对应原setReadTimeout）
                .setConnectionRequestTimeout(TIMEOUT_MS) // 连接池获取连接超时
                .build();

        // 构建适配Spring Boot 3.0的HttpClient实例
        CloseableHttpClient httpClient = HttpClients.custom()
                .setDefaultRequestConfig(requestConfig)
                .setSSLHostnameVerifier(NoopHostnameVerifier.INSTANCE)
                .build();

        HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);

        return new RestTemplate(requestFactory);
    }
}

补充说明 #

若偏好使用 Spring 工厂类的超时方法，可改用基于 Duration 的重载版本，例如 requestFactory.setConnectTimeout(Duration.ofMillis(TIMEOUT_MS))，但仍推荐通过 RequestConfig 统一配置，避免分散设置导致的混乱。

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