RestTemplateBuilder自动配置Bean设置超时不生效问题求助

使用Spring Boot自动配置的RestTemplateBuilder Bean时，手动设置的超时参数未按预期生效，但自定义RestTemplateBuilder Bean时，超时设置可正常生效。

自动配置Bean的情况 #

代码示例：

public WebHookService(RestTemplateBuilder restTemplateBuilder) {
    restTemplate = restTemplateBuilder
            .setConnectTimeout(Duration.ofSeconds(10))
            .setReadTimeout(Duration.ofSeconds(30))
            .build();
}

结果：实际超时参数未应用，连接和读取超时仍为默认值。

自定义Bean的情况 #

代码示例：

@Bean
RestTemplateBuilder restTemplateBuilder() {
    return new RestTemplateBuilder();
}

// ...

public WebHookService(RestTemplateBuilder restTemplateBuilder) {
    restTemplate = restTemplateBuilder
            .setConnectTimeout(Duration.ofSeconds(10))
            .setReadTimeout(Duration.ofSeconds(30))
            .build();
}

结果：超时参数正确生效，连接超时为10秒，读取超时为30秒。

原因分析 #

Spring Boot自动配置的RestTemplateBuilder并非原生空实例，它会被以下机制修改：

1. 配置文件参数覆盖：自动配置的RestTemplateBuilder会优先读取application.properties/application.yml中spring.resttemplate.connect-timeout、spring.resttemplate.read-timeout等配置项的值，覆盖手动设置的参数。
2. RestTemplateBuilderCustomizer 定制：Spring Boot自动配置会加载所有实现RestTemplateBuilderCustomizer接口的Bean，这些定制器会对RestTemplateBuilder进行统一配置，且优先级高于手动调用的setConnectTimeout、setReadTimeout等方法，导致手动设置被覆盖。

而自定义的RestTemplateBuilder Bean完全由开发者控制，不会自动读取配置文件参数，也不会被默认的RestTemplateBuilderCustomizer处理，因此手动设置的超时参数能正常生效。

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