Spring集成测试@DirtiesContext场景下如何启停Testcontainers容器

你当前实现里的DockerComposeContainer是@DynamicPropertySource方法内的局部变量，生命周期完全和Spring应用上下文解绑：

• @DirtiesContext触发旧上下文销毁时，销毁逻辑拿不到这个方法内部的局部变量，根本无法触发容器停止操作
• 容器实例没有绑定任何生命周期回调，测试执行完成、甚至测试进程退出后，启动的容器都会持续留在后台运行
• 每次属性注入阶段都会新建一个完全独立的容器实例，没有任何复用、清理逻辑，测试执行次数越多，后台残留的堆叠容器越多

你用的JUnit 4.x + Cucumber 7.4.1栈不需要额外引入测试扩展，直接把容器生命周期交给Spring上下文托管即可，配合@DirtiesContext就能完美实现「上下文启动前拉起全新容器组、上下文销毁后自动清理对应容器」的需求，具体代码如下：

@CucumberContextConfiguration
@SpringBootTest(classes = TestConfig.class)
// 明确指定每个测试方法执行完成后就销毁上下文，保证下一个测试拿到全新环境
@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_EACH_TEST_METHOD)
public class CucumberITConfig {

    // 将容器定义为Spring Bean，绑定初始化、销毁回调
    @Bean(initMethod = "start", destroyMethod = "stop")
    public DockerComposeContainer<?> testDockerComposeStack() {
        return new DockerComposeContainer(new File("docker-compose.yml"))
                .withExposedService("rabbitmq", 5672)
                // 给测试compose栈设置独立项目名，避免和本地运行的compose服务冲突
                .withProject("it-test-" + UUID.randomUUID());
    }

    @DynamicPropertySource
    private static void injectProps(DynamicPropertyRegistry registry, DockerComposeContainer<?> composeContainer) {
        // 直接注入上下文初始化完成的容器实例，不需要在属性方法里手动启动容器
        registry.add("spring.rabbitmq.host", () -> composeContainer.getServiceHost("rabbitmq", 5672));
        registry.add("spring.rabbitmq.port", () -> composeContainer.getServicePort("rabbitmq", 5672));
        // 其他依赖服务（比如Redis、PostgreSQL）的连接属性都可以在这里统一注入
    }
}

关键配置说明 #

• @Bean(initMethod = "start", destroyMethod = "stop")：容器的启动、停止完全和Spring上下文生命周期绑定：上下文刷新前自动执行start()拉起容器，@DirtiesContext触发上下文销毁时自动执行stop()停止并删除对应容器
• @DynamicPropertySource方法直接注入容器Bean：Spring会在属性注入阶段提前初始化这个容器Bean，不需要在静态方法里手动new、手动调用start()，避免重复创建容器实例
• Testcontainers默认启动的Ryuk侧车容器会做兜底资源回收：哪怕测试进程OOM、被强制终止，Ryuk也会在连接断开后10秒内自动删除所有关联的测试容器，从机制上避免容器残留
• 显式设置@DirtiesContext的classMode为AFTER_EACH_TEST_METHOD，确保每个测试执行完成后都会触发上下文销毁逻辑，下一个测试启动时会重新创建上下文、拉起全新的容器组，完全满足干净测试环境的要求

• 不要在@DynamicPropertySource方法里手动调用container.start()，容器启动逻辑已经交给Bean的初始化方法处理，手动调用会导致重复启动
• 同一个DockerComposeContainer实例可以声明多个暴露服务，不需要为每个依赖服务单独创建compose容器实例
• 如果你的测试类层级有公共的父类配置，不要把容器Bean定义在父类里，避免上下文继承导致容器复用、达不到每次测试环境干净的要求

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