mockmvc全覆盖测试需分层覆盖路径、参数、异常和响应断言，基于内存中spring mvc全流程执行，高效可重复；应涵盖各http方法、正常与异常流、响应内容及头信息，并用@webmvctest精准隔离。

用 MockMvc 对 REST 接口做全覆盖测试，关键不在“写多少个 test 方法”，而在于**分层覆盖请求路径、参数组合、异常分支和响应断言**。它不依赖真实 HTTP 服务，直接在内存中走完 Spring MVC 全流程——从 DispatcherServlet 到 Controller、再到返回值处理，效率高且可重复。

覆盖核心请求方式与路径

每个 HTTP 方法（GET/POST/PUT/DELETE）都应有对应测试，尤其注意路径变量、查询参数、请求体格式是否被正确解析：

• GET 请求：用 MockMvcRequestBuilders.get("/api/users/{id}", 123) 测试路径变量；搭配 .param("page", "1") 测试查询参数
• POST/PUT 请求：用 .contentType(MediaType.APPLICATION_JSON) + .content(jsonString) 模拟 JSON 提交；确保 @RequestBody 正确绑定
• 表单提交：用 .contentType(MediaType.MULTIPART_FORM_DATA) 或 .param("name", "value") 测试 @RequestParam 或 @ModelAttribute

覆盖正常流与异常流

只测“成功返回 200”远远不够。要主动触发业务校验、参数校验、全局异常处理器的响应：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• 空参/非法参数：比如 POST 空 JSON、必填字段缺失，验证是否返回 400 及具体错误信息
• 业务异常：如用户不存在、权限不足，检查是否被 @ControllerAdvice 捕获并返回预期状态码（如 404 / 403）和结构化错误体
• 全局异常兜底：故意抛出 RuntimeException，确认是否统一返回 500 并含 traceId 等调试字段

覆盖响应内容与头信息

断言不能只停留在 status().isOk()。真实接口常需校验响应体结构、字段值、Content-Type、自定义 Header 等：

• 响应体：用 .andExpect(content().json("{\"code\":200,\"data\":{\"id\":1}}")) 验证 JSON 结构；或用 andReturn().getResponse().getContentAsString() 手动解析后断言
• 响应头：如 .andExpect(header().string("X-Request-ID", notNullValue()))，验证链路追踪字段
• 重定向：对返回 redirect:/xxx 的接口，用 .andExpect(redirectedUrl("/login"))

用@WebMvcTest 精准隔离测试范围

避免启动整个 Spring 上下文。对纯 Controller 层测试，优先使用 @WebMvcTest(YourController.class)：

• 它默认只加载 Web 相关 Bean（Controller、Converter、Validator），跳过 Service、Repository、DataSource，速度快、干扰少
• 若需注入特定 Mock 服务，用 @MockBean YourService mockService 替换真实实现
• 慎用 @SpringBootTest：它启动全量上下文，适合跨层集成验证，但不应作为 Controller 单测的默认选择

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南