1. 为什么我们需要MockMvc测试在SpringBoot项目开发中接口测试是保证代码质量的重要环节。传统测试方式需要启动完整应用上下文耗时且可能受到外部依赖影响。MockMvc通过模拟HTTP请求和响应让我们能在不启动服务器的情况下对控制器进行隔离测试。我经历过一个电商项目支付接口因为缺少边界测试导致线上事故。后来引入MockMvc后类似问题在测试阶段就能被发现。这种测试方式特别适合快速验证控制器逻辑检查参数绑定是否正确测试异常处理流程持续集成环境中的自动化测试2. 环境准备与基础配置2.1 依赖引入首先确保pom.xml中包含测试相关依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency注意SpringBoot 2.2版本默认包含JUnit5如果使用JUnit4需要额外配置2.2 测试类基础结构典型的测试类结构如下SpringBootTest AutoConfigureMockMvc public class UserControllerTest { Autowired private MockMvc mockMvc; Test public void testGetUser() throws Exception { // 测试用例将写在这里 } }关键注解说明SpringBootTest加载完整应用上下文AutoConfigureMockMvc自动配置MockMvc实例3. GET接口测试实战3.1 单个参数GET请求测试假设有个查询用户接口GetMapping(/users) public User getUser(RequestParam Long id) { return userService.getById(id); }测试用例可以这样写Test public void testGetUserWithSingleParam() throws Exception { mockMvc.perform(MockMvcRequestBuilders.get(/users) .param(id, 123)) .andExpect(MockMvcResultMatchers.status().isOk()) .andExpect(MockMvcResultMatchers.jsonPath($.id).value(123)); }关键点解析perform()发起请求param()添加请求参数andExpect()断言响应结果3.2 多个参数GET请求测试对于多参数接口GetMapping(/users/search) public ListUser searchUsers( RequestParam String name, RequestParam Integer age) { // 业务逻辑 }测试方法Test public void testSearchUsersWithMultiParams() throws Exception { mockMvc.perform(MockMvcRequestBuilders.get(/users/search) .param(name, 张三) .param(age, 25)) .andExpect(status().isOk()) .andExpect(jsonPath($.length()).value(2)); }经验参数较多时建议使用LinkedMultiValueMap封装参数提高可读性4. POST接口测试详解4.1 表单格式POST请求测试表单提交接口PostMapping(/users) public ResponseEntity createUser(UserForm form) { // 创建用户逻辑 }测试用例Test public void testCreateUserWithFormData() throws Exception { mockMvc.perform(MockMvcRequestBuilders.post(/users) .contentType(MediaType.APPLICATION_FORM_URLENCODED) .param(username, testUser) .param(password, 123456)) .andExpect(status().isCreated()); }4.2 JSON格式POST请求对于接收JSON的接口PostMapping(/users/json) public ResponseEntity createUserByJson(RequestBody UserDTO dto) { // 业务逻辑 }测试方法Test public void testCreateUserWithJson() throws Exception { String userJson {\username\:\jsonUser\,\password\:\654321\}; mockMvc.perform(MockMvcRequestBuilders.post(/users/json) .contentType(MediaType.APPLICATION_JSON) .content(userJson)) .andExpect(status().isCreated()) .andExpect(jsonPath($.username).value(jsonUser)); }技巧使用ObjectMapper将对象转为JSON字符串更可靠String json new ObjectMapper().writeValueAsString(userDTO);5. 高级测试场景处理5.1 请求头设置测试需要特定请求头的接口Test public void testApiWithHeaders() throws Exception { mockMvc.perform(MockMvcRequestBuilders.get(/secure/api) .header(Authorization, Bearer token123) .header(X-Custom-Header, value)) .andExpect(status().isOk()); }5.2 会话和Cookie测试测试依赖会话的接口Test public void testSessionApi() throws Exception { mockMvc.perform(MockMvcRequestBuilders.get(/cart) .sessionAttr(userId, 123)) .andExpect(status().isOk()); }5.3 文件上传测试测试文件上传接口Test public void testFileUpload() throws Exception { MockMultipartFile file new MockMultipartFile( file, test.txt, text/plain, file content.getBytes()); mockMvc.perform(MockMvcRequestBuilders.multipart(/upload) .file(file) .param(name, testFile)) .andExpect(status().isOk()); }6. 常见问题与解决方案6.1 404错误排查遇到404错误时检查请求路径是否正确请求方法GET/POST等是否匹配是否缺少必要的注解如RestController6.2 参数绑定失败常见原因参数名称不匹配参数类型不兼容缺少必需的参数解决方案.andExpect(MockMvcResultMatchers.jsonPath($.errors[0]).value(参数id不能为空))6.3 性能优化建议使用WebMvcTest替代SpringBootTest进行切片测试重用MockMvc实例BeforeEach public void setup() { this.mockMvc MockMvcBuilders.webAppContextSetup(context).build(); }对静态结果使用MockMvcResultHandlers.print()调试7. 测试最佳实践命名规范测试类名被测试类名Test测试方法名test被测试方法名测试场景断言原则每个测试用例应有明确的断言优先验证行为而非实现细节对关键业务逻辑添加边界测试测试数据管理使用BeforeEach初始化测试数据考虑使用内存数据库如H2进行集成测试日志输出.andDo(MockMvcResultHandlers.print())异常测试示例Test public void testInvalidParam() throws Exception { mockMvc.perform(get(/users).param(id, abc)) .andExpect(status().isBadRequest()); }在实际项目中我发现合理的MockMvc测试能减少约40%的接口相关bug。特别是在微服务架构中良好的接口测试能显著降低联调成本。建议对核心业务接口保持90%以上的测试覆盖率对参数校验等边界情况要重点测试。
