Spring Boot 3.x复用TestContainers MongoDB容器测试失败求助

核心原因 #

静态MongoDB容器在首个测试类执行结束后被关闭，后续测试类重建Spring上下文时，无法复用或重新连接已关闭的容器，导致连接拒绝。

解决方案 #

1. 正确开启TestContainers容器复用 #

容器复用需要代码配置+全局配置两步：

• 在静态容器实例上添加.withReuse(true)：

@SpringBootTest
@Testcontainers(disabledWithoutDocker = true)
public abstract class MongoContainerTest {

    @Container
    @ServiceConnection
    static MongoDBContainer mongoDBContainer = new MongoDBContainer("mongo:7.0.9-rc1")
            .withReuse(true); // 开启容器复用
}

• 在src/test/resources下创建testcontainers.properties文件，添加全局复用开关：

testcontainers.reuse.enable=true

注：复用的容器会在JVM退出时自动清理，或通过docker rm手动删除。

2. 确保Spring测试上下文缓存生效 #

Spring Boot测试默认会缓存相同配置的上下文，避免重复创建。如果仍出现上下文重建问题，可在父类添加@TestInstance(TestInstance.Lifecycle.PER_CLASS)，强制测试实例生命周期为类级别，减少上下文重建概率：

@SpringBootTest
@Testcontainers(disabledWithoutDocker = true)
@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public abstract class MongoContainerTest {
    // ... 容器定义
}

3. 手动管理容器生命周期（备选方案） #

如果自动管理仍有问题，可手动控制容器启动/关闭，绕过@Testcontainers的自动生命周期管理：

@SpringBootTest
public abstract class MongoContainerTest {

    static MongoDBContainer mongoDBContainer;

    static {
        mongoDBContainer = new MongoDBContainer("mongo:7.0.9-rc1")
                .withReuse(true);
        mongoDBContainer.start();
        // 手动绑定配置，替代@ServiceConnection
        System.setProperty("spring.data.mongodb.uri", mongoDBContainer.getReplicaSetUrl());
    }
}

这种方式直接通过系统属性注入Mongo连接地址，避免上下文重建时的属性绑定问题。

4. 排查测试类配置差异 #

确保所有继承MongoContainerTest的测试类没有自定义@SpringBootTest属性（如properties、classes），否则Spring会认为配置不同，重建上下文，导致@ServiceConnection无法复用已有容器的连接信息。

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