在Spring Boot项目中，MockMvc是测试RESTful API的强大工具，它允许我们模拟HTTP请求，而无需启动完整的Servlet容器。然而，当我们需要测试那些接收JSON请求体（通过@RequestBody注解）的接口时，如何将Java对象作为请求参数传递给MockMvc常常会成为一个疑问。本教程将详细介绍解决这一问题的标准方法。
理解 @RequestBody 与 MockMvc 请求体
Spring MVC的@RequestBody注解用于将HTTP请求体的内容绑定到方法的参数上。通常，当客户端发送JSON数据时，Spring会使用内置的HTTP消息转换器（如Jackson ObjectMapper）将其反序列化为对应的Java对象。
在MockMvc测试中，我们无法直接将Java对象实例传递给请求构建器（如post()或put()方法）。MockMvc模拟的是真实的HTTP请求，这意味着请求体必须是原始的字节流或字符串形式。因此，我们需要手动将Java对象序列化为JSON字符串，然后将其作为请求体内容发送。
核心步骤：对象序列化与请求构建
实现这一目标的关键在于使用Jackson库的ObjectMapper将Java对象转换为JSON字符串，并将其设置到MockMvcRequestBuilders的content()方法中，同时指定正确的Content-Type头部。
1. 准备待发送的 Java 对象
首先，定义你希望作为请求体发送的Java对象。以问题中提到的CartDto为例：
public class CartDto {
private String itemId;
private int quantity;
// Getters and Setters
public CartDto() {} // Default constructor is often required by Jackson
public CartDto(String itemId, int quantity) {
this.itemId = itemId;
this.quantity = quantity;
}
public String getItemId() {
return itemId;
}
public void setItemId(String itemId) {
this.itemId = itemId;
}
public int getQuantity() {
return quantity;
}
public void setQuantity(int quantity) {
this.quantity = quantity;
}
}2. 将 Java 对象序列化为 JSON 字符串
使用Jackson ObjectMapper将CartDto实例转换为JSON字符串。ObjectMapper是Jackson库的核心类，用于JSON的序列化和反序列化。
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.core.JsonProcessingException;
// ... 在你的测试类中 ...
ObjectMapper objectMapper = new ObjectMapper();
CartDto cartDto = new CartDto("item001", 2);
String jsonContent;
try {
jsonContent = objectMapper.writeValueAsString(cartDto);
} catch (JsonProcessingException e) {
// 处理序列化异常，例如记录日志或抛出运行时异常
throw new RuntimeException("Failed to serialize CartDto to JSON", e);
}
System.out.println("Generated JSON: " + jsonContent);
// 预期输出示例: Generated JSON: {"itemId":"item001","quantity":2}3. 构建 MockMvc 请求并发送 JSON 内容
现在，有了JSON字符串，你可以将其传递给MockMvcRequestBuilders的content()方法。同时，务必使用contentType(MediaType.APPLICATION_JSON)设置请求的Content-Type头部，以告知Spring这是一个JSON请求。
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
import org.springframework.http.MediaType;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
// ... 在你的测试类中 ...
// 假设 mockMvc 已经被 @Autowired 或手动初始化
// @Autowired
// private MockMvc mockMvc;
// ... 接续上面的 jsonContent 生成代码 ...
mockMvc.perform(MockMvcRequestBuilders.post("/user/addItemIntoCart")
.contentType(MediaType.APPLICATION_JSON) // 声明请求体是JSON格式
.content(jsonContent)) // 将JSON字符串作为请求体内容
.andExpect(status().isOk()) // 期望HTTP状态码为200 OK
.andReturn(); // 获取MvcResult完整示例代码
下面是一个完整的MockMvc测试方法示例，展示了如何测试一个接收CartDto作为@RequestBody参数的控制器方法。
import com.fasterxml.jackson.databind.ObjectMapper;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.test.mock.mockito.MockBean;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
// 模拟的 CartDto 类
class CartDto {
private String itemId;
private int quantity;
public CartDto() {}
public CartDto(String itemId, int quantity) {
this.itemId = itemId;
this.quantity = quantity;
}
public String getItemId() { return itemId; }
public void setItemId(String itemId) { this.itemId = itemId; }
public int getQuantity() { return quantity; }
public void setQuantity(int quantity) { this.quantity = quantity; }
}
// 模拟的 CartService 接口
interface CartService {
ResponseEntity addItemIntoCart(CartDto cartDto);
}
// 模拟的 UserController
@RestController
@RequestMapping("/user")
class UserController {
private final CartService cartService;
public UserController(CartService cartService) {
this.cartService = cartService;
}
@PostMapping(value = "/addItemIntoCart", consumes = {"application/json"})
public ResponseEntity addItemToCart(@RequestBody CartDto cartDto) {
return cartService.addItemIntoCart(cartDto);
}
}
@WebMvcTest(UserController.class) // 针对 UserController 进行 Web 层测试
public class UserControllerTest {
@Autowired
private MockMvc mockMvc;
@MockBean // 模拟 CartService，避免真实的服务层调用
private CartService cartService;
private ObjectMapper objectMapper;
@BeforeEach
void setUp() {
objectMapper = new ObjectMapper(); // 初始化 ObjectMapper
}
@Test
void testAddItemIntoCart() throws Exception {
// 1. 准备待发送的 CartDto 对象
CartDto cartDto = new CartDto("productXYZ", 3);
// 2. 将 CartDto 对象序列化为 JSON 字符串
String jsonContent = objectMapper.writeValueAsString(cartDto);
// 3. 模拟 CartService 的行为（可选，但通常需要）
// 当 cartService.addItemIntoCart 被调用时，返回一个成功的 ResponseEntity
when(cartService.addItemIntoCart(any(CartDto.class)))
.thenReturn(ResponseEntity.ok("Item added successfully"));
// 4. 构建 MockMvc 请求并发送 JSON 内容
mockMvc.perform(post("/user/addItemIntoCart")
.contentType(MediaType.APPLICATION_JSON) // 设置 Content-Type
.content(jsonContent)) // 设置请求体内容
.andExpect(status().isOk()) // 验证 HTTP 状态码是否为 200 OK
.andExpect(content().string("Item added successfully")); // 验证响应体内容
}
} 注意事项
- Content-Type 头部的重要性：务必使用contentType(MediaType.APPLICATION_JSON)。如果缺少此头部或设置错误，Spring MVC将无法正确识别请求体为JSON，并可能导致415 Unsupported Media Type错误或@RequestBody无法绑定。
- ObjectMapper 实例：在测试中，你可以直接创建new ObjectMapper()实例。如果你的应用对ObjectMapper有特殊的配置（例如日期格式、忽略未知属性等），并且这些配置会影响JSON的序列化/反序列化，那么你可能需要注入或使用Spring上下文提供的ObjectMapper实例，以确保测试环境与生产环境的行为一致。
- 异常处理：objectMapper.writeValueAsString()可能会抛出JsonProcessingException。在测试代码中，通常将其向上抛出（throws Exception）或包装为运行时异常，以便测试框架捕获。
- 其他 HTTP 方法：对于接收请求体的PUT请求，也采用完全相同的方法：序列化对象为JSON，然后通过put().content().contentType()发送。
- 依赖：确保你的项目中包含了Jackson库的依赖，通常在Spring Boot项目中，这会通过spring-boot-starter-web自动引入。
总结
通过本教程，我们学习了在Spring Boot MockMvc测试中，如何有效地将Java对象作为JSON请求体传递给控制器方法。核心在于利用Jackson ObjectMapper将Java对象序列化为JSON字符串，并通过MockMvcRequestBuilders的contentType()和content()方法构建模拟请求。掌握这一技巧对于编写健壮、准确的REST API集成测试至关重要，它能帮助你模拟真实的客户端行为，从而全面验证你的控制器逻辑。
