正文：

在 Spring 生态中，RestTemplate 是调用 RESTful 服务的核心工具类，但其依赖注入和测试 Mocking 常让开发者陷入困境。尤其在微服务架构中，如何优雅地管理 RestTemplate 的实例化，并确保单元测试的可控性，成为亟待解决的问题。

依赖注入的痛点

默认情况下，RestTemplate 并非 Spring 容器托管的 Bean，直接通过 new 实例化会导致以下问题：
1. 难以复用：每次调用都创建新实例，浪费资源。
2. 难以配置：拦截器、错误处理器等需手动设置，代码冗余。
3. 难以测试：无法通过 Spring 的依赖注入替换 Mock 对象。

解决方案：将 RestTemplate 交给 Spring 管理

通过 @Configuration 声明 Bean，统一配置超时、拦截器等参数：

@Configuration  
public class RestTemplateConfig {  
    @Bean  
    public RestTemplate restTemplate() {  
        RestTemplate restTemplate = new RestTemplate();  
        restTemplate.setErrorHandler(new CustomErrorHandler());  
        return restTemplate;  
    }  
}

在服务类中直接注入使用：

@Service  
public class ApiService {  
    @Autowired  
    private RestTemplate restTemplate;  

    public String fetchData(String url) {  
        return restTemplate.getForObject(url, String.class);  
    }  
}

Mocking 难题与破解

单元测试时，需 Mock RestTemplate 的行为。传统方式如直接 Mock 方法调用会破坏 Spring 上下文，推荐以下两种方案：

方案1：使用 @MockBean 替换真实 Bean

Spring Boot 提供的 @MockBean 可动态替换容器中的 Bean，结合 Mockito 实现行为模拟：

@SpringBootTest  
public class ApiServiceTest {  
    @MockBean  
    private RestTemplate restTemplate;  

    @Autowired  
    private ApiService apiService;  

    @Test  
    public void testFetchData() {  
        String mockResponse = "{\"status\":\"success\"}";  
        when(restTemplate.getForObject(anyString(), eq(String.class)))  
            .thenReturn(mockResponse);  

        String result = apiService.fetchData("http://example.com");  
        assertEquals(mockResponse, result);  
    }  
}

方案2：纯 Mockito 非侵入式测试

若不想启动 Spring 上下文，可通过构造函数注入 + Mockito 实现：

public class ApiServicePureTest {  
    private RestTemplate restTemplate = mock(RestTemplate.class);  
    private ApiService apiService = new ApiService(restTemplate);  

    @Test  
    public void testFetchData() {  
        String mockResponse = "{\"status\":\"success\"}";  
        when(restTemplate.getForObject(anyString(), eq(String.class)))  
            .thenReturn(mockResponse);  

        String result = apiService.fetchData("http://example.com");  
        assertEquals(mockResponse, result);  
    }  
}

最佳实践建议

1. 始终注入 Bean：避免手动实例化，提升可测试性。
2. 区分测试场景：轻量级测试用 Mockito，集成测试用 @MockBean。
3. 合理配置：通过 RestTemplateBuilder 定制连接池、超时等参数。

通过以上方法，开发者既能享受 RestTemplate 的便捷性，又能确保代码的可测试性，真正实现“写代码时想着测试”的理想状态。