Spring Boot集成测试加载ApplicationContext失败排查求助

核心问题分析 #

测试报错的根源是Spring测试上下文加载时，permissionResolver依赖的organizationService bean无法被找到，而生产环境能正常启动，说明测试环境的上下文配置存在遗漏或冲突。

1. 修复上下文加载冲突 #

你当前测试类同时使用了@SpringBootTest和@ContextConfiguration，这两个注解在上下文加载逻辑上存在重叠：

• @SpringBootTest默认会自动扫描测试类所在包及其子包的@SpringBootApplication启动类，完成全量上下文初始化
• 未指定配置类的@ContextConfiguration会尝试加载测试类同名的配置文件/类，若不存在则会打乱@SpringBootTest的加载逻辑

解决方案：直接移除@ContextConfiguration注解，同时确保@SpringBootTest能扫描到项目的启动类：

@RunWith(SpringRunner.class)
// 指定项目启动类，确保Spring能扫描到所有业务组件
@SpringBootTest(classes = YourApplicationMainClass.class)
@AutoConfigureMockMvc
public class SubsidiaryControllerTest {
    // ... 原有代码
}

2. 关于@RunWith(SpringRunner.class)的疑问 #

• Spring Boot 2.2及以上版本，@SpringBootTest已默认集成SpringRunner功能，低版本则必须保留该注解
• 移除后报错消失是因为Spring未加载完整上下文，自然不会触发依赖注入校验，但MockMvc也无法被初始化，因此必须保留该注解，同时修复上下文加载问题

3. 多模块POM结构的合理性 #

父pom依赖spring-boot-starter-parent、子模块继承本项目父模块的结构是Spring Boot多模块项目的标准写法，用于统一管理版本依赖，本身不会导致测试报错，无需怀疑该结构。

4. 额外排查与优化点 #

• 检查依赖模块：若organizationService在其他子模块，确保测试模块的pom已引入该子模块的依赖
• 检查测试配置：确认application-test.properties是否缺失生产环境的必要配置项，导致bean初始化失败
• 完善Mock逻辑：第二个测试方法中，@MockBean的subsidiaryService默认返回null，需添加mock行为模拟数据不存在场景：

@Test
public void shouldReturnNotFoundResponse() throws Exception {
    // 模拟根据ID查询不到数据的场景
    when(subsidiaryService.findById("0000")).thenReturn(Optional.empty());
    
    mockMvc.perform(get("/api/subsidiary/0000"))
            .andExpect(status().isNotFound());
}

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