如何运行Spring Boot所有JUnit测试 解决批量运行上下文报错问题

核心结论 #

单个测试类独立运行正常、批量运行大面积失败，与所有测试类添加@SpringBootTest注解无关。Spring测试框架默认会对配置完全一致的ApplicationContext做缓存，不会无意义重复启动上下文。这类问题的本质是测试间状态污染或配置冲突。

常见根因 #

• 测试类修改了共享状态：部分测试运行时修改了Spring Bean的单例对象属性、JVM静态变量、系统属性、环境变量，或者操作测试数据库/缓存后未回滚脏数据。单测独立运行时上下文初始状态干净，所以运行正常；批量运行时前序测试留下的脏状态会导致后续测试加载上下文失败。
• 测试配置不一致：不同测试类使用了不同的@ActiveProfiles、@TestPropertySource、@MockBean、@ContextConfiguration配置，Spring会判定需要加载独立的上下文，不同配置的上下文如果存在Bean重名、Profile冲突，就会抛出Bean创建异常。
• 资源竞争：部分测试硬编码占用固定端口、固定临时文件路径，批量运行时前序测试未释放资源，后续测试启动时获取资源失败。

排查步骤 #

1. 定位首个失败的测试类
   批量运行时控制台输出的第一个抛出IllegalStateException: Failed to load ApplicationContext的测试类是问题根因，后续所有报错都是连带异常。可以在src/test/resources路径下创建junit-platform.properties文件，添加配置固定测试执行顺序，方便复现：

junit.jupiter.testclass.order.default=org.junit.jupiter.api.ClassOrderer$ClassName

固定按类名字母序执行后，第一个报错的类就是排查起点。
2. 复现污染链路
找到首个失败的测试类X后，按执行顺序选择X之前的所有测试类+X一起运行，如果X复现失败，就用二分法逐步缩小范围，定位到具体是哪个前序测试类修改了共享状态。
3. 针对性修复

• 对使用了@MockBean/@SpyBean修改上下文Bean、或者修改了上下文全局配置的测试类，添加@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_CLASS)注解，标记该测试类运行完成后清空上下文缓存，避免影响后续测试。
• 对修改了静态变量、系统属性的测试逻辑，在@AfterEach/@AfterAll生命周期方法中还原修改的参数为默认值。
• 对操作数据库、缓存的测试类，添加@Transactional注解，测试执行完成后自动回滚所有数据操作，避免残留脏数据。
• 对需要启动web容器的测试，不要硬编码服务端口，使用@LocalServerPort注解注入动态分配的端口，避免端口冲突。

IntelliJ运行全量测试+生成覆盖率的正确操作 #

• 不需要手动创建自定义JUnit运行配置，直接选中src/test/java目录右键，选择Run 'All Tests'即可运行所有单元测试；需要生成覆盖率报告时选择Run 'All Tests' with Coverage，运行完成后可在Coverage面板导出HTML格式的覆盖率报告。
• 也可以直接通过Maven/Gradle侧边栏的test任务运行全量测试，这种方式与CI流水线执行逻辑完全一致，不会出现IDE配置差异导致的运行异常。
• 为了提升批量运行速度，可以统一所有@SpringBootTest注解的配置参数、激活的Profile、加载的配置类，Spring会自动复用缓存的上下文，大幅减少上下文启动次数。

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