Java REST Web服务Service层单元测试如何调用@RestControllerAdvice
问题核心原因
- 你当前测试类虽然标注了
@RunWith(SpringRunner.class),但没有配置任何Spring上下文加载规则,运行时根本不会初始化Spring容器,本质就是纯Mockito单元测试,和你直接写main方法手动实例化Service类调用没有区别。 @RestControllerAdvice的异常拦截能力完全依托Spring MVC核心组件DispatcherServlet实现,工作流程是:Web请求进入Controller后如果抛出未被捕获的异常,会被DispatcherServlet拦截,路由到全局异常处理器的对应方法生成响应。- 这套拦截链路从设计上就和Service层完全解耦,哪怕正常启动Web应用,Service层抛出异常后也不会直接触发全局异常处理器,必须等异常向上冒泡到Controller层、进入Spring MVC的处理流程后才会被拦截。
可行的解决方案
- 保留Service层单元测试的现有写法:你当前用
assertThrows校验Service是否按要求抛出预期异常的逻辑完全符合单元测试的目标,这层测试不需要耦合Web层的异常处理逻辑,只要验证异常抛出的正确性即可。 - 单独验证全局异常处理器的逻辑:如果需要确认全局异常处理器能正确处理Service抛出的异常,单独编写Web层切片测试即可。使用
@WebMvcTest注解的测试类会自动加载Spring MVC的异常拦截链路,自动将@RestControllerAdvice类注册到DispatcherServlet的异常处理注册表,你可以模拟接口调用,触发Service抛出指定异常,直接断言返回的响应状态码、响应体是否和异常处理器的定义一致。 - 如果一定要在当前测试类里联动验证异常处理方法:不需要依赖Spring容器的自动拦截逻辑,手动实例化异常处理器对象,把测试中捕获到的异常直接传入对应的处理方法即可,示例代码如下:
@Test public void testException() { // 捕获Service层抛出的异常 Exception caughtEx = assertThrows(Exception.class, () -> { // 触发异常抛出的业务代码 }); // 手动实例化全局异常处理器 ExceptionHandler globalHandler = new ExceptionHandler(); // 直接调用对应异常处理方法 ResponseEntity<Object> processResult = globalHandler.handleUnknownException(caughtEx); // 断言处理结果是否符合预期 assertEquals(HttpStatus.INTERNAL_SERVER_ERROR, processResult.getStatusCode()); assertEquals("Body Here", processResult.getBody()); }
避坑提醒
不要为了触发异常处理器的逻辑,启动完整的Spring Boot上下文来跑Service层测试,这种写法会大幅拖慢测试执行速度,偏离单元测试快速、聚焦单一逻辑的设计初衷。
内容的提问来源于stack exchange,提问作者Nahid Shah
相关产品推荐
相关产品推荐

