本文解析 Spring Boot 单元测试中 MockMvc 调用返回空响应的根本原因：因 DTO 对象引用不匹配导致 Mockito 模拟失效，进而使控制器返回 null，最终序列化为空 JSON；并提供基于 ArgumentMatchers.any() 的标准修复方案。
本文解析 spring boot 单元测试中 `mockmvc` 调用返回空响应的根本原因：因 dto 对象引用不匹配导致 mockito 模拟失效，进而使控制器返回 `null`，最终序列化为空 json；并提供基于 `argumentmatchers.any()` 的标准修复方案。
在 Spring Boot 单元测试中，使用 MockMvc 测试 REST 控制器时，一个常见却隐蔽的问题是：预期返回非空 JSON，实际却得到空字符串（""）或 null 响应体。如您所见，测试断言失败提示 expected: [{"balance":3000.0}] but was: []，而 Postman 中相同接口却能正确返回 {"balance":3000.0} —— 这并非序列化配置错误，而是Mockito 模拟逻辑未被触发所致。
根本原因在于对象匹配机制：
您的测试中写有：
UserAmountDTO userAmountDTO = new UserAmountDTO(2000.0, 3000.0); when(userService.updateUserBalance(1, userAmountDTO)).thenReturn(userAmountDTO);
这段代码要求 Mockito 严格匹配参数值 + 引用地址。但在真实请求流程中，@RequestBody 会由 Jackson 反序列化生成一个全新实例（例如内存地址 @21943jf3），它虽字段值相同（amount=2000.0, balance=3000.0），但与测试中手动构造的 userAmountDTO（如 @21835tj3）引用不同。因此 when(...).thenReturn(...) 完全未生效，userService.updateUserBalance(...) 实际返回 null，控制器最终返回 new ResponseEntity(null, HttpStatus.OK)，Jackson 序列化 null 得到空字符串。
✅ 正确做法：放弃精确对象匹配，改用类型安全的参数匹配器：
import static org.mockito.ArgumentMatchers.*;
import static org.mockito.Mockito.*;
// 替换原 mock 行：
when(userService.updateUserBalance(eq(1), any(UserAmountDTO.class)))
.thenReturn(new UserAmountDTO(2000.0, 5000.0)); // 注意：此处返回值应反映业务逻辑（如 balance 更新后为 5000.0）
同时，请确保 UserAmountDTO 具备无参构造函数（Lombok @AllArgsConstructor 不含无参构造，需显式添加 @NoArgsConstructor 或 @RequiredArgsConstructor 配合 @AllArgsConstructor），否则 Jackson 反序列化可能失败：
@Getter
@Setter
@NoArgsConstructor // ✅ 必须添加
@AllArgsConstructor
public class UserAmountDTO {
@JsonProperty(access = JsonProperty.Access.WRITE_ONLY)
private double amount; // 建议设为 private + getter/setter
@JsonProperty(access = JsonProperty.Access.READ_ONLY)
private double balance;
}
? 额外注意事项：
- @JsonProperty(access = WRITE_ONLY) 仅影响序列化/反序列化方向：amount 可写入（请求体中允许）、不可读出（响应体中不出现）；balance 可读出（响应体中存在）、不可写入（请求体中被忽略）。这与测试问题无关，但需确保 DTO 设计符合 API 规约。
- MockMvc 的 .with(...) 自定义请求构建器中设置 setAttribute("userId", 1) 是正确做法，无需修改。
- 断言时建议使用 JsonPath 进行结构化校验，而非拼接字符串，提升可维护性：
mockMvc.perform(...) .andExpect(status().isOk()) .andExpect(jsonPath("$.balance", is(5000.0)));
总结：REST 单元测试中“响应为空”大概率是模拟未命中所致。牢记——所有经 @RequestBody 进入控制器的 DTO，都应视为新创建的对象，必须用 any(Class.class) 匹配，而非原始实例引用。这是 Spring 测试实践中一条关键经验法则。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
