Spring Boot中RestTemplate调用第三方API Socket timeout配置不生效问题

核心问题原因 #

你在HttpClient层面配置的超时参数没有生效，根因是HttpComponentsClientHttpRequestFactory执行请求时的配置优先级高于HttpClient的默认配置：
当你传入预构建的CloseableHttpClient创建HttpComponentsClientHttpRequestFactory实例时，若没有显式设置该工厂类的超时参数，它会默认生成一套RequestConfig（读超时、连接超时默认值为0，代表永不超时）覆盖你在HttpClient上设置的默认配置，导致1600ms的超时阈值完全没有生效。

修复方案 #

方案一（更推荐，配置逻辑更清晰） #

直接在HttpComponentsClientHttpRequestFactory实例上设置超时参数，无需在HttpClient中配置RequestConfig：

public ClientHttpRequestFactory getClientHttpRequestFactory(String timeout) {
    int timeoutMs = Integer.parseInt(timeout);
    CloseableHttpClient closeableHttpClient = HttpClientBuilder.create().build();
    HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory(closeableHttpClient);
    // 建立TCP连接的超时时间
    factory.setConnectTimeout(timeoutMs);
    // 从连接池获取连接的超时时间
    factory.setConnectionRequestTimeout(timeoutMs);
    // Socket读超时（即服务端响应超时阈值）
    factory.setReadTimeout(timeoutMs);
    return factory;
}

方案二（兼容原有HttpClient配置逻辑） #

关闭HttpComponentsClientHttpRequestFactory的内置RequestConfig生成逻辑，强制使用HttpClient的默认配置：

public ClientHttpRequestFactory getClientHttpRequestFactory(String timeout) {
    RequestConfig requestConfig = RequestConfig.custom()
            .setConnectTimeout(Integer.parseInt(timeout))
            .setConnectionRequestTimeout(Integer.parseInt(timeout))
            .setSocketTimeout(Integer.parseInt(timeout))
            .build();
    CloseableHttpClient closeableHttpClient = HttpClientBuilder.create()
            .setDefaultRequestConfig(requestConfig)
            .build();
    HttpComponentsClientHttpRequestFactory factory = new HttpComponentsClientHttpRequestFactory(closeableHttpClient);
    // 禁用工厂类内置的请求配置覆盖逻辑
    factory.setBufferRequestBody(false);
    return factory;
}

补充注意项 #

你当前的异常捕获逻辑存在日志漏打问题：log.error("Error:", ex.getCause()); 只会打印异常的cause对象，若抛出的超时异常本身没有cause（比如直接抛出SocketTimeoutException），日志不会输出任何异常栈，会让你误以为没有抛出异常。建议修改为打印完整异常：

catch (Exception ex){
   log.error("调用第三方接口异常", ex);
}

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