运行Spring Boot Web测试用例时遇NoClassDefFoundError异常求助

你在编写Spring Boot Web测试时碰到的两个NoClassDefFoundError问题——都是找不到AsyncRequestTimeoutException类，尤其是给MockMvc附加Rest Controller Advice时触发异常，我来帮你梳理原因并给出针对性的解决方案：

问题根源分析 #

AsyncRequestTimeoutException是Spring Web模块处理异步请求超时的核心类，出现类找不到的情况，通常是以下原因导致：

• 依赖缺失/版本不匹配：Spring Web相关依赖未正确引入，或者测试依赖（如spring-boot-starter-test）与核心Web依赖版本不一致，导致类无法被加载。
• 测试上下文配置错误：你使用的MockitoJUnitRunner.class仅负责初始化Mockito的Mock对象，不会加载完整的Spring Web上下文，而@SpringBootTest需要配合Spring专属Runner才能正确加载Web相关组件。
• MockMvc初始化不完整：手动初始化MockMvc时未启用异步请求支持，导致依赖异步组件的Rest Controller Advice无法正常加载。

具体解决方案 #

1. 检查并完善依赖配置 #

确保项目中已正确引入Spring Web和测试依赖，且版本统一（推荐用Spring Boot父依赖管理版本）：

Maven示例（pom.xml）

<dependencies>
    <!-- 核心Web依赖，必须引入 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 测试依赖，包含MockMvc等测试工具 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
        <!-- 若存在JUnit Vintage冲突可排除，可选操作 -->
        <!-- <exclusions>
            <exclusion>
                <groupId>org.junit.vintage</groupId>
                <artifactId>junit-vintage-engine</artifactId>
            </exclusion>
        </exclusions> -->
    </dependency>
</dependencies>

Gradle示例（build.gradle）

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

2. 调整测试类配置与MockMvc初始化方式 #

你的测试类混用了Mockito Runner和@SpringBootTest，导致Spring Web上下文未正确加载，建议做以下调整：

方案A：使用Spring Runner加载完整上下文

将@RunWith(MockitoJUnitRunner.class)替换为@RunWith(SpringRunner.class)，并用@MockBean替代@Mock（让Mock对象被Spring上下文管理），同时正确初始化MockMvc并启用异步支持：

@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class AccountDetailsControllerTest {
    @MockBean // 替换@Mock，让Mock被Spring上下文管理
    private AccountDetailService accountDetailService;
    
    private MockMvc mockMvc;
    
    @Autowired
    private YourRestControllerAdvice restControllerAdvice; // 注入你的Advice
    
    @Before
    public void setUp() {
        // 初始化MockMvc时添加Advice，并启用异步请求处理
        mockMvc = MockMvcBuilders.standaloneSetup(new AccountDetailsController())
                .setControllerAdvice(restControllerAdvice)
                .asyncDispatch(true) // 关键：启用异步支持
                .build();
    }
    
    // 你的测试方法...
}

方案B：用@WebMvcTest专注测试Web层（更轻量）

如果不需要完整的Spring上下文，仅需测试Controller层，推荐使用@WebMvcTest，它会自动配置MockMvc和Web相关组件：

@RunWith(SpringRunner.class)
@WebMvcTest(AccountDetailsController.class)
public class AccountDetailsControllerTest {
    @MockBean
    private AccountDetailService accountDetailService;
    
    @Autowired
    private MockMvc mockMvc;
    
    @Autowired
    private YourRestControllerAdvice restControllerAdvice;
    
    // 测试方法直接使用mockMvc即可，无需手动初始化
}

3. 确保Rest Controller Advice正常加载 #

如果你的Advice专门处理AsyncRequestTimeoutException，可以在测试类中添加异步配置确保组件被初始化：

@Configuration
public class TestAsyncConfig implements WebMvcConfigurer {
    @Override
    public void configureAsyncSupport(AsyncSupportConfigurer configurer) {
        configurer.setDefaultTimeout(3000); // 设置默认超时时间
        configurer.registerCallableInterceptors(timeoutInterceptor());
    }
    
    @Bean
    public TimeoutCallableProcessingInterceptor timeoutInterceptor() {
        return new TimeoutCallableProcessingInterceptor();
    }
}

然后在测试类上添加@Import(TestAsyncConfig.class)导入该配置，确保异步相关组件能被加载。

总结 #

先从依赖配置入手，确保Web和测试依赖正确引入；再调整测试类的Runner和MockMvc初始化方式，让Spring Web上下文正常加载；最后若Advice依赖异步组件，补充对应的测试配置即可解决问题。

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