替换Autowired依赖为接口/抽象类后Spring Boot MVC测试失败排查

问题描述 #

在Spring Boot MVC项目中：

• 原Controller直接注入MyService实现类时，对应的Spock测试可正常运行：Mock的MyService抛出HttpClientErrorException会被@ExceptionHandler(HttpStatusCodeException.class)捕获并完成重定向。
• 将Controller依赖替换为MyInterface接口（其实现类为MyServiceThatImplementsAnInterfaceImpl）后，测试中Mock抛出的HttpClientErrorException不再被全局异常处理器捕获，而是被包装成NestedServletException嵌套抛出，导致测试失败。

相关代码片段 #

原Controller代码 #

import com.myorg.service.MyService;
// 原代码内容

异常处理代码 #

@ExceptionHandler(HttpStatusCodeException.class)
// 原代码内容

原测试代码 #

import com.myorg.service.MyService;
// 原代码内容

修改后的Controller代码 #

import com.myorg.service.MyServiceThatImplementsAnInterface;
// 原代码内容

接口实现类代码 #

@Component("myInterface")
// 原代码内容

修改后的测试代码 #

@SpringBootTest
// 原代码内容

失败堆栈信息 #

Request processing failed;...（原堆栈内容）

排查原因 #

1. Spring代理机制差异：当注入接口类型时，Spring默认使用JDK动态代理，该代理会将未声明的异常包装为UndeclaredThrowableException，随后被Servlet容器进一步包装成NestedServletException；而注入实现类时，Spring使用CGLIB代理，不会对异常进行额外包装，因此全局处理器能直接捕获目标异常。
2. 全局异常处理器范围限制：原@ExceptionHandler仅监听HttpStatusCodeException类型，无法识别被嵌套包装后的异常，导致异常未被处理。

解决方法 #

方法1：扩展异常处理器的处理范围 #

修改全局异常处理器，同时处理NestedServletException，并解析出内部的实际异常：

@ExceptionHandler({HttpStatusCodeException.class, NestedServletException.class})
public ModelAndView handleException(Exception ex) {
    Throwable actualEx = ex;
    // 解析嵌套异常的根因
    if (ex instanceof NestedServletException) {
        actualEx = ((NestedServletException) ex).getRootCause();
    }
    // 复用原有的HttpStatusCodeException处理逻辑
    if (actualEx instanceof HttpStatusCodeException) {
        HttpStatusCodeException statusEx = (HttpStatusCodeException) actualEx;
        // 原重定向或响应处理逻辑
        ModelAndView mv = new ModelAndView();
        mv.setViewName("redirect:/error-page");
        mv.addObject("status", statusEx.getStatusCode().value());
        return mv;
    }
    // 其他异常的默认处理
    return new ModelAndView("error");
}

方法2：强制使用CGLIB代理 #

修改Spring配置，强制对所有Bean使用CGLIB代理，避免JDK代理的异常包装：

• 方式一：在配置类上添加注解

@Configuration
@EnableAspectJAutoProxy(proxyTargetClass = true)
public class AppConfig {
    // 配置内容
}

• 方式二：在application.properties中添加配置

spring.aop.proxy-target-class=true

方法3：检查Spock测试的Mock逻辑 #

确保测试中Mock接口时，异常被正确抛出且未被拦截：

given:
MyInterface myServiceMock = Mock(MyInterface)
// 明确抛出目标异常
myServiceMock.doBusiness() >> { throw new HttpClientErrorException(HttpStatus.BAD_REQUEST, "Test Error") }

when:
mockMvc.perform(get("/api/test"))

then:
// 验证重定向或响应状态
response.redirectedUrl == "/error-page"

内容的提问来源于stack exchange，提问作者Space Cadet