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
相关产品推荐
相关产品推荐

