Spring Boot中使用@HttpExchange与RestClient设置请求超时的方法

你的超时配置不生效，核心问题在于缺少读取超时设置，同时代码里存在冗余的重复配置，另外还要确认依赖是否正确引入。以下是具体的修复步骤：

1. 先排查依赖（关键前提） #

HttpComponentsClientHttpRequestFactory依赖Apache HttpClient 5，如果你没引入这个依赖，RestClient会自动回退到默认的SimpleClientHttpRequestFactory，导致你的配置完全不生效。

Maven 依赖配置 #

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

Gradle 依赖配置 #

implementation 'org.apache.httpcomponents.client5:httpclient5'

2. 修正超时配置代码 #

你之前只设置了连接超时和连接请求超时，但读取超时（等待服务器响应数据的超时）才是绝大多数场景下控制请求整体耗时的关键。同时去掉重复的连接超时设置，统一用更清晰的Duration参数：

@Bean
public BonusPayoutRestClient restClient() {
    RestClient restClient = RestClient.builder()
            .baseUrl("%s://%s/".formatted(protocol, internalApiUrl))
            .requestFactory(getClientHttpRequestFactory())
            .build();
    RestClientAdapter adapter = RestClientAdapter.create(restClient);
    HttpServiceProxyFactory factory = HttpServiceProxyFactory.builderFor(adapter)
            .build();
    return factory.createClient(BonusPayoutRestClient.class);
}

private ClientHttpRequestFactory getClientHttpRequestFactory() {
    HttpComponentsClientHttpRequestFactory clientHttpRequestFactory = new HttpComponentsClientHttpRequestFactory();
    // 建立与服务器连接的超时时间
    clientHttpRequestFactory.setConnectTimeout(Duration.ofSeconds(10));
    // 从连接池获取空闲连接的超时时间
    clientHttpRequestFactory.setConnectionRequestTimeout(Duration.ofSeconds(10));
    // 等待服务器返回响应数据的超时时间（核心！之前缺失的配置）
    clientHttpRequestFactory.setResponseTimeout(Duration.ofSeconds(15));
    return clientHttpRequestFactory;
}

3. 可选：用默认工厂简化配置（无需额外依赖） #

如果不需要Apache HttpClient的高级特性，也可以直接用RestClient默认的SimpleClientHttpRequestFactory配置超时，省去引入额外依赖的步骤：

@Bean
public BonusPayoutRestClient restClient() {
    RestClient restClient = RestClient.builder()
            .baseUrl("%s://%s/".formatted(protocol, internalApiUrl))
            .requestFactory(() -> {
                SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
                factory.setConnectTimeout(10000); // 连接超时，单位毫秒
                factory.setReadTimeout(15000);    // 读取超时，单位毫秒
                return factory;
            })
            .build();
    RestClientAdapter adapter = RestClientAdapter.create(restClient);
    HttpServiceProxyFactory factory = HttpServiceProxyFactory.builderFor(adapter)
            .build();
    return factory.createClient(BonusPayoutRestClient.class);
}

验证配置是否生效 #

可以调用一个故意延迟响应的测试API（比如后端代码sleep 20秒），观察是否会在你设置的读取超时时间点抛出超时异常，以此确认配置生效。

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