@WebMvcTest测试加载ApplicationContext失败问题求助

你遇到的核心问题是@WebMvcTest默认会加载主应用类ServerApplication上的所有注解，而@EnableConfigServer触发的自动配置和测试环境不兼容，最终引发了找不到entityManagerFactory Bean的错误。下面是几个针对性的解决方案：

1. 排除冲突的自动配置类 #

直接在@WebMvcTest注解中排除Config Server及可能关联的JPA自动配置类，让测试上下文只加载Web层需要的配置：

@RunWith(SpringRunner.class)
@WebMvcTest(
    controllers = UserController.class,
    excludeAutoConfiguration = {ConfigServerAutoConfiguration.class, HibernateJpaAutoConfiguration.class}
)
@ActiveProfiles({"dev", "native"})
public class UserControllerTest {
    // 你的现有测试代码保持不变
}

其中ConfigServerAutoConfiguration是@EnableConfigServer背后的核心自动配置类，HibernateJpaAutoConfiguration则是触发entityManagerFactory依赖的根源（如果你的项目依赖了JPA相关starter）。

2. 重构主应用类，拆分配置注解 #

把@EnableConfigServer这类与Web MVC测试无关的注解拆分到单独的配置类中，避免@WebMvcTest误加载：

首先创建独立的Config Server配置类：

@Configuration
@EnableConfigServer
public class ConfigServerConfig {
    // 无需额外代码，注解已满足配置需求
}

然后修改ServerApplication，移除@EnableConfigServer：

@Configuration
@EnableAutoConfiguration
@SpringBootConfiguration
@ComponentScan(excludeFilters = {@ComponentScan.Filter(type= FilterType.ASSIGNABLE_TYPE, value=AppPropertiesConfiguration.class)})
@ServletComponentScan
@EnableRetry
@Log4j2
public class ServerApplication {
    // 现有代码保持不变
}

这样@WebMvcTest默认只会加载Web MVC相关配置，不会触发Config Server的自动配置，也就不会引入不必要的JPA依赖。

3. 手动指定测试上下文的配置类 #

如果前两种方法不适用，你可以用@ContextConfiguration手动指定测试所需的配置类，完全绕过主应用类的扫描：

@RunWith(SpringRunner.class)
@WebMvcTest(controllers = UserController.class)
@ActiveProfiles({"dev", "native"})
@ContextConfiguration(classes = {WebMvcConfig.class}) // 替换为你的Web MVC专属配置类
public class UserControllerTest {
    // 现有测试代码保持不变
}

这里的WebMvcConfig应仅包含Web层相关配置，不要混入Config Server或JPA的配置内容。

问题根源补充说明 #

@WebMvcTest的设计初衷是只加载Web层相关Bean，但Spring Boot默认会将主应用类作为配置类的一部分加载。你的ServerApplication上的@EnableConfigServer触发了一系列自动配置，其中可能包含了JPA自动配置（若项目依赖spring-boot-starter-data-jpa），而测试环境未配置数据库，导致Spring无法创建entityManagerFactory Bean，最终引发ApplicationContext加载失败。

你可以通过添加--debug参数运行测试，查看自动配置报告，确认哪些配置被意外加载，进一步辅助定位问题。

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