You need to enable JavaScript to run this app. Spring Boot CRUD控制器单元测试断言失败、Mock存根异常排查
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot CRUD控制器单元测试断言失败、Mock存根异常排查

测试报错问题排查指南

1. POST接口相关报错处理

报错现象

  • 接口断言期望返回200,实际返回400
  • 抛出UnfinishedStubbingException,提示customerRepo.save方法的存根语句缺少thenReturn

根因说明

UnfinishedStubbingException是Mockito框架的语法校验类异常,触发原因是编写的方法存根语句为不完整的断链状态:当执行到when(xxx)语句时,没有立刻衔接thenReturn/thenThrow等返回定义,就直接执行了后续的MockMvc请求逻辑,会直接打断Mockito的存根解析流程。
这个异常不会被MockMvc的正常流程捕获,会导致Web请求的参数校验上下文失效,连带触发400错误响应,和业务逻辑本身无关。

排查与解决步骤

  • 逐行检查所有Mockito存根语句的完整性,确保所有存根都是完整的链式写法
  • 不要混用参数匹配器和固定参数:如果存根里用了any()、eq()这类匹配器,方法的所有入参都必须使用匹配器,禁止单独传固定对象值,否则很容易触发存根断链
  • 检查存根语句有没有被意外打断:比如写when(customerRepo.save(时,还没写完参数和返回定义,就切换到写MockMvc的请求代码,也会触发存根不完整的异常
  • 检查MockMvc发起POST请求时传递的JSON格式:确保字段名和Controller入参的字段完全匹配,没有遗漏带@NotNull/@NotBlank校验的必填字段

正确存根写法参考:

// 错误写法:缺返回值定义,触发UnfinishedStubbingException
when(customerRepo.save(any(Customer.class)));

// 正确写法:完整的存根链
when(customerRepo.save(any(Customer.class)))
    .thenReturn(Customer.builder().id(1L).name("测试客户").build());

2. DELETE接口相关报错处理

报错现象

  • 接口断言期望返回200,实际返回404
  • 测试中已经手动模拟customerRepo.findById(1L)返回Optional.empty()

根因说明

按照Controller的逻辑,当查询不到对应客户ID时,应该主动抛出ResourceNotFoundException,但实际返回404的核心原因是:@WebMvcTest注解默认的扫描范围只覆盖Controller层组件,不会自动加载项目中定义的全局异常处理器(@ControllerAdvice)
如果自定义异常是通过全局异常处理器映射成对应HTTP状态码的,在Web测试场景下这个处理器没有被加载,抛出的ResourceNotFoundException不会被转换为标准的错误响应,Spring会默认判定请求路径不存在,直接返回404。

排查与解决步骤

  • 检查ResourceNotFoundException的状态码映射逻辑:如果是在全局异常处理器中通过@ExceptionHandler定义的,需要手动把这个异常处理器加入@WebMvcTest的扫描范围,参考配置:
@WebMvcTest(
    controllers = CrudController.class,
    advice = GlobalExceptionHandler.class
)
  • 确认DELETE请求的路径和Controller路由完全匹配:检查是否漏写了项目配置的context-path,是否把/customers/1错写为单复数不一致的路径,路径不匹配会直接触发Spring的默认404响应
  • 如果自定义异常上直接加了@ResponseStatus(HttpStatus.NOT_FOUND)注解,需要确认这个异常类能被测试上下文扫描到,不要出现包路径扫不到的情况

内容的提问来源于stack exchange,提问作者ashil

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 16:36:04