Spring Boot TestRestTemplate返回空Body等测试问题求助

问题1：修改测试URL仍通过 #

大概率是你的测试没有真正发起HTTP请求，常见原因及解决：

• 测试类未配置真实服务器环境：默认@SpringBootTest使用MOCK环境，不会启动真实服务器，TestRestTemplate仅做模拟调用，不会校验URL匹配。需添加配置启用真实端口：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class YourControllerTest {
    @Autowired
    private TestRestTemplate restTemplate;
    // ...
}

• 测试未添加URL有效性断言：如果只调用请求方法但不校验响应状态，测试会默认“不抛异常即通过”。需补充状态码断言：

@Test
void testInvalidUrl() {
    ResponseEntity<String> response = restTemplate.getForEntity("/wrong-path", String.class);
    Assert.assertEquals(HttpStatus.NOT_FOUND, response.getStatusCode());
}

• 控制器路径匹配过宽：比如控制器用了@RequestMapping("/**")，修改后的URL仍能被匹配到，需调整控制器的路径注解为精确匹配。

问题2：TestRestTemplate响应Body为null #

常见误区及解决：

• 控制器未返回有效响应体：比如方法返回void、null，或未标注@ResponseBody（或未用@RestController）。需确保控制器返回有效内容：

@RestController
@RequestMapping("/demo")
public class DemoController {
    @GetMapping
    public String getContent() {
        return "valid-body-content";
    }
}

• 调用方法与响应类型不匹配：比如用getForObject时指定的类型和实际返回类型不兼容，导致反序列化失败。改用getForEntity查看完整响应：

ResponseEntity<String> response = restTemplate.getForEntity("/demo", String.class);
System.out.println(response.getStatusCode()); // 先确认请求是否成功
System.out.println(response.getBody());

问题3：自定义响应头未出现在响应中 #

常见原因及解决：

• 设置头的方式冲突：比如同时用HttpServletResponse和ResponseEntity设置头，后者会覆盖前者。统一用ResponseEntity管理响应体和头：

@GetMapping("/with-header")
public ResponseEntity<String> getWithCustomHeader() {
    HttpHeaders headers = new HttpHeaders();
    headers.add("X-My-Custom-Header", "custom-value");
    return new ResponseEntity<>("content", headers, HttpStatus.OK);
}

• 测试未正确获取头：getForObject只能拿到响应体，必须用getForEntity或exchange才能获取响应头：

ResponseEntity<String> response = restTemplate.getForEntity("/with-header", String.class);
String customHeader = response.getHeaders().getFirst("X-My-Custom-Header");
Assert.assertEquals("custom-value", customHeader);

• 头被过滤器/拦截器移除：检查项目中是否有安全框架或自定义拦截器，确认是否存在移除自定义头的逻辑。

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