未指定Bean创建配置时RestTemplate为何无法自动注入？

Spring 核心容器以及 Spring Boot 的自动配置模块，默认不会向应用上下文注册全局的RestTemplate类型Bean，因此直接使用@Autowired等方式尝试注入时，会抛出No qualifying bean of type 'RestTemplate' available的异常。

这里有个常见的认知误区：很多开发者引入spring-web相关依赖后，会默认框架已经托管RestTemplate实例，但实际上Spring Boot仅在自动配置中默认注册了RestTemplateBuilder构建器Bean，从未直接提供配置完成的RestTemplate单例。

你提到的「需要开发者结合自身需求定制配置」是核心原因之一，但不是全部，完整的设计逻辑可以分为三点：

• 配置无普适默认值：RestTemplate作为HTTP调用客户端，所有核心参数都和业务场景强绑定，不存在能适配绝大多数场景的默认配置。包括连接超时、读取超时、SSL校验规则、请求拦截器（日志、鉴权、签名）、消息转换器、连接池参数、错误处理器等，如果框架硬编码一套默认值，反而容易引发生产问题——比如默认无超时会导致级联服务雪崩，固定超时值又无法适配内部服务调用、第三方接口调用等不同场景的时延要求。
• 避免多Bean冲突，保留多实例灵活性：如果框架默认注册一个RestTemplate Bean，一旦开发者自定义了同类型Bean，很容易出现同类型多Bean的注入冲突，额外增加问题排查成本。同时实际业务中往往需要多个配置完全不同的RestTemplate实例：比如调用内部微服务的实例配置短超时、开启长连接，调用第三方开放平台的实例配置长超时、加签名校验拦截器，默认提供单例Bean反而会限制使用灵活性。
• 组件演进方向的选择：目前RestTemplate已经处于维护模式，Spring 官方在后续版本中更推荐使用响应式非阻塞的WebClient作为HTTP客户端的首选实现，因此也不会调整现有逻辑，新增RestTemplate的默认自动注册配置。

最基础的RestTemplate注册方式参考如下，可以直接利用框架默认提供的RestTemplateBuilder快速完成参数定制：

@Configuration
public class RestTemplateConfig {
    @Bean
    public RestTemplate restTemplate(RestTemplateBuilder builder) {
        return builder
                .setConnectTimeout(Duration.ofSeconds(5))
                .setReadTimeout(Duration.ofSeconds(10))
                // 按需添加拦截器、消息转换器等配置
                .build();
    }
}

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