推荐用@WebMvcTest+MockMvc组合测试Spring MVC Controller，它轻量快速、只加载Web层组件，需用@MockBean模拟Service依赖，并支持JSONPath断言、异常处理和安全认证等场景。

Java 中对 Spring MVC 的 Controller 做单元测试，推荐用 Spring Boot Test 提供的 @WebMvcTest + MockMvc 组合，它轻量、启动快、专注 Web 层逻辑，不加载整个应用上下文。

用 @WebMvcTest 注解隔离测试 Web 层

该注解会自动配置 Spring MVC 基础设施（如 DispatcherServlet、@ControllerAdvice），并只扫描目标 Controller 类（或包），跳过 Service、Repository 等其他 Bean，避免全量上下文启动。

• 加在测试类上，指定要测试的 Controller：

  @WebMvcTest(UserController.class)

• 若需启用部分组件（如自定义 Converter 或 Validator），可用 includeFilters 或 excludeFilters
• 默认不加载 @Component、@Service，所以依赖的 Service 需手动 mock

用 MockMvc 发起模拟 HTTP 请求

MockMvc 是 Spring 提供的无容器 HTTP 测试工具，可构造 GET/POST 请求、设置 Header、传参、解析 JSON 响应，全程不启动真实 Tomcat。

Alibabacloud Sdk Client Initialization For Java

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

下载

• 通过 @Autowired 注入：

  MockMvc mockMvc;

• 典型写法示例（测试返回 JSON）：
  

  mockMvc.perform(get("/api/users/123")<br>    .contentType(MediaType.APPLICATION_JSON))<br>    .andExpect(status().isOk())<br>    .andExpect(jsonPath("$.name").value("Alice"));

• 支持链式断言：状态码、响应头、响应体（JSONPath / XPath / 内容匹配）

用 @MockBean 替换 Controller 依赖的 Service

Controller 通常调用 Service，而 @WebMvcTest 不加载 Service Bean，必须显式 mock 它们，@MockBean 是最直接的方式。

立即学习“Java免费学习笔记（深入）”；

• 在测试类中声明：

  @MockBean private UserService userService;

• 然后在测试方法里设定行为：

  when(userService.findById(123L)).thenReturn(new User("Alice"));

• @MockBean 会覆盖容器中同类型的 Bean，确保 Controller 调用的是你控制的 mock 实例

处理常见场景的小技巧

实际测试中常遇到参数校验、异常处理、文件上传等，可以这样应对：

• 请求参数校验失败：发送非法参数后，检查是否返回 400 BAD_REQUEST 和错误字段，配合 @Valid + BindingResult 的 Controller 行为
• 全局异常处理：确保你的 @ControllerAdvice 类被 @WebMvcTest 扫描到（默认会），再验证自定义错误响应格式
• JWT 或登录态：用 SecurityMockMvcRequestPostProcessors 添加认证信息，例如：

  .with(jwt().authorities(new SimpleGrantedAuthority("ROLE_USER")))

• 表单提交或文件上传：用 fileUpload() 或 param() 构造对应请求类型