Spring Boot单元测试：如何在多测试类间共享TestContainer？

问题原因 #

你的代码中，@Container注解由Testcontainers的JUnit Jupiter扩展管理，默认行为是每个测试类结束后停止对应的容器。两个测试类都继承了ContainerTest基类，当第一个测试类运行完成后，扩展会停止共享的容器实例，导致第二个测试类尝试连接时容器已停止，从而抛出连接异常。

解决方案1：启用容器重用（推荐） #

通过配置容器重用，让Testcontainers在测试结束后保留容器，供后续测试类复用，同时减少容器重复启动的开销。

步骤1：修改基类代码 #

将容器实例改为不可变的val，并添加withReuse(true)启用重用：

@Testcontainers
open class ContainerTest {
    companion object {
        @Container
        val postgresDBContainer = PostgreSQLContainer<Nothing>("postgres:13.4-alpine").apply {
            withExposedPorts(5432)
            withDatabaseName("testdb")
            withUsername("testuser")
            withPassword("testpass")
            withReuse(true) // 开启容器重用
        }

        @DynamicPropertySource
        @JvmStatic
        fun dbProperties(registry: DynamicPropertyRegistry) {
            registry.add("spring.datasource.url", postgresDBContainer::getJdbcUrl)
            registry.add("spring.datasource.password", postgresDBContainer::getPassword)
            registry.add("spring.datasource.username", postgresDBContainer::getUsername)
        }
    }
}

步骤2：启用全局重用配置 #

在src/test/resources下创建testcontainers.properties文件，添加以下配置：

testcontainers.reuse.enable=true

解决方案2：手动管理容器生命周期 #

如果不想启用容器重用，可以通过@BeforeAll和@AfterAll手动控制容器的启动与停止，确保容器在所有测试类运行期间保持活跃。

修改基类代码 #

移除@Testcontainers和@Container注解，手动管理容器生命周期：

open class ContainerTest {
    companion object {
        val postgresDBContainer = PostgreSQLContainer<Nothing>("postgres:13.4-alpine").apply {
            withExposedPorts(5432)
            withDatabaseName("testdb")
            withUsername("testuser")
            withPassword("testpass")
        }

        @BeforeAll
        @JvmStatic
        fun startContainer() {
            postgresDBContainer.start()
        }

        @AfterAll
        @JvmStatic
        fun stopContainer() {
            postgresDBContainer.stop()
        }

        @DynamicPropertySource
        @JvmStatic
        fun dbProperties(registry: DynamicPropertyRegistry) {
            registry.add("spring.datasource.url", postgresDBContainer::getJdbcUrl)
            registry.add("spring.datasource.password", postgresDBContainer::getPassword)
            registry.add("spring.datasource.username", postgresDBContainer::getUsername)
        }
    }
}

补充说明 #

• 方案1的容器重用会保留容器实例，直到你手动删除（通过Docker命令或Testcontainers工具），适合频繁运行测试的场景。
• 方案2会在所有测试完成后自动销毁容器，适合一次性测试或需要每次测试都使用全新容器的场景。

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