SpringBoot测试执行中Context提前关闭致H2表异常问题排查

核心现象 #

• 500个测试用例批量执行时，Spring Context在测试未全部完成前提前关闭，触发Hibernate执行drop table操作删除H2数据库表
• 后续测试通过@Sql脚本插入数据时，抛出表不存在异常
• 单独运行失败测试可正常执行，已移除@DirtyContext注解及devtools依赖

可能原因及排查方向 #

1. Spring Test上下文缓存冲突 #

Spring Test会根据WebMergedContextConfiguration的唯一key缓存ApplicationContext，若不同测试类的配置存在细微差异（如@ActiveProfiles、@SpringBootTest参数），会导致旧上下文被销毁、新上下文被创建，但后续测试可能错误依赖已销毁的上下文资源。

• 对比日志中Storing ApplicationContext的key值，确认失败测试前后的上下文key是否一致，排查是否存在上下文被意外替换销毁的情况
• 检查失败测试类的配置（如activeProfiles = '{new}'）是否与其他测试类存在差异，导致缓存key变化

2. 异步任务未完成触发上下文关闭 #

日志显示ThreadPoolTaskExecutor被关闭，若测试或应用代码中存在未完成的异步任务，Spring会在单个测试结束后直接关闭上下文，而后续测试可能仍依赖该上下文的数据库资源。

• 排查代码中是否有@Async标注的异步方法，确保测试结束前所有异步任务已执行完成
• 针对存在异步逻辑的测试类，可添加@DirtiesContext(methodMode = DirtiesContext.MethodMode.AFTER_METHOD)，避免上下文缓存引发的资源冲突
• 测试环境可强制异步任务同步执行，示例配置：

@Configuration
public class TestAsyncConfig {
    @Bean
    public TaskExecutor taskExecutor() {
        return new SyncTaskExecutor(); // 同步执行器，避免异步任务残留
    }
}

3. Hibernate DDL配置问题 #

检查测试环境的JPA配置：

• 若spring.jpa.hibernate.ddl-auto设为create-drop，上下文关闭时Hibernate会自动删除所有表；若后续测试复用的上下文未重新执行建表逻辑，就会出现表不存在异常
• 尝试将ddl-auto改为create或update，或在测试类上添加@Sql(scripts = "/scripts/test/create_tables.sql", executionPhase = Sql.ExecutionPhase.BEFORE_TEST_CLASS)，手动提前执行建表脚本

4. 测试并行执行或生命周期异常 #

• 检查Maven Surefire/Gradle测试插件是否开启并行执行，并行测试可能引发上下文资源竞争，导致提前关闭
• 排查测试类中是否存在@AfterClass、@PreDestroy等方法手动销毁上下文或数据库资源

5. 新上下文初始化异常 #

从日志看，新上下文被缓存后旧上下文被销毁，但后续测试使用的新上下文可能未正确初始化数据库表：

• 开启spring.jpa.show-sql=true，查看失败测试执行前是否有create table的SQL输出，确认DDL操作是否执行
• 验证application-new.properties（对应activeProfiles = '{new}'）中的JPA配置是否正确，确保DDL自动创建功能正常启用

验证步骤 #

1. 在失败测试中添加日志，输出当前ApplicationContext的ID，确认上下文是否被正确切换
2. 临时禁用上下文缓存：在失败测试类添加@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_EACH_TEST_METHOD)，若问题消失则说明缓存机制是诱因
3. 检查@Sql脚本是否依赖已存在的表，确认脚本执行前表已被正确创建

内容的提问来源于stack exchange，提问作者Raúl Pampliega Mayoral