TestRestTemplate是Spring Boot集成测试专用HTTP客户端，自动集成ApplicationContext，支持JSON序列化、认证、自定义Header等，需配合@SpringBootTest(webEnvironment=RANDOM_PORT)使用。
在 Spring Boot 项目中，TestRestTemplate 是专为集成测试设计的轻量级 HTTP 客户端，它自动集成 ApplicationContext，支持 JSON 自动序列化/反序列化、基础认证、自定义 header 等，适合测试 Controller 层完整 HTTP 请求响应流程（含路由、参数绑定、状态码、响应体、异常处理等）。
启用 TestRestTemplate
确保测试类使用 @SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT) 或 .INTEGRATION 模式，这样容器会启动嵌入式服务器（如 Tomcat），并允许通过真实端口发起 HTTP 调用。
直接注入即可：
@Autowired private TestRestTemplate restTemplate;
也可手动构建（适用于需自定义配置的场景）：
TestRestTemplate restTemplate = new TestRestTemplate(
new RestTemplateBuilder()
.basicAuthentication("user", "pass")
.setConnectTimeout(Duration.ofSeconds(5))
);
发送 GET 请求并验证响应
最常见的是测试 RESTful 查询接口。假设有一个 GET /api/users/{id} 接口返回 User 对象：
- 使用
getForObject()获取反序列化后的对象（推荐用于成功响应） - 使用
getForEntity()获取完整ResponseEntity，可断言状态码、header 和 body
示例：
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
ResponseEntity<user> response = restTemplate.getForEntity("/api/users/1", User.class);
assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(response.getBody()).isNotNull();
assertThat(response.getBody().getName()).isEqualTo("Alice");
</user>
发送 POST 请求并携带 JSON 数据
测试创建接口（如 POST /api/users）时，TestRestTemplate 默认使用 MappingJackson2HttpMessageConverter，可直接传入 Java 对象：
- 构造请求体对象（如
new User("Bob", "bob@example.com")） - 调用
postForEntity()，自动序列化为 JSON 并设置Content-Type: application/json - 检查返回的
ResponseEntity：状态码应为201 CREATED，Location header 应包含新资源路径
示例：
User newUser = new User("Bob", "bob@example.com");
ResponseEntity<user> response = restTemplate.postForEntity("/api/users", newUser, User.class);
assertThat(response.getStatusCode()).isEqualTo(HttpStatus.CREATED);
assertThat(response.getHeaders().getLocation()).isNotNull();
</user>
处理认证、Header 和错误响应
TestRestTemplate 支持灵活的请求定制：
- 带 Basic Auth：用
new TestRestTemplate("user", "pass")构造，或在 builder 中调用.basicAuthentication() - 自定义 Header：使用
HttpEntity封装请求体和 headers - 捕获错误响应：即使返回 4xx/5xx，
restTemplate默认不抛异常；用exchange()方法配合ResponseEntity手动检查
示例（带 token 的请求）：
HttpHeaders headers = new HttpHeaders();
headers.setBearerAuth("eyJhbGciOiJIUzI1NiJ9...");
HttpEntity<string> entity = new HttpEntity(headers);
ResponseEntity<string> response = restTemplate.exchange(
"/api/admin/data", HttpMethod.GET, entity, String.class
);
assertThat(response.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
</string></string>
不复杂但容易忽略：务必确认 Controller 方法有正确注解（如 @RestController、@GetMapping）、实体类有无参构造器和 getter/setter，且测试类在 Spring Boot 主应用包扫描路径下，否则端点不会被注册。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
