单例Testcontainers多测试类断言失败，添加@Testcontainers/@Container恢复正常

问题现象 #

使用单例模式实现Testcontainers时，第一个测试类执行完全正常，但后续所有测试类均出现断言失败——尽管日志显示测试场景执行流程无异常，断言却始终不通过。在抽象测试类中添加@Testcontainers注解，并为PostgreSQLContainer实例加上@Container注解后，所有测试类恢复正常运行。

原因分析 #

1. Spring测试上下文缓存与动态属性绑定问题 #

Spring测试默认会缓存测试上下文，当多个测试类共享同一上下文时，@DynamicPropertySource中的数据库配置只会在第一次上下文初始化时被加载。如果容器未被Testcontainers管理，后续测试类启动时，即使容器状态有变化（或上下文因Bean定义差异刷新），动态属性也不会重新绑定，导致测试使用的数据库连接信息与实际容器状态不匹配。

2. Testcontainers生命周期管理缺失 #

未添加@Testcontainers和@Container时，容器是通过静态代码块手动启动的，Testcontainers无法感知容器的生命周期，也无法在测试上下文刷新时同步容器的最新状态。而@Testcontainers注解会触发Testcontainers的Spring扩展，@Container标记的容器会被纳入Testcontainers的生命周期管理，确保每次上下文初始化时，动态属性都能正确绑定到容器的当前配置。

3. 静态单例的局限性 #

静态容器实例在JVM生命周期内仅初始化一次，但Spring测试上下文可能因测试类的Bean定义差异（比如不同测试类注入的Repository不同）触发上下文刷新。此时手动启动的容器无法同步上下文的动态属性更新，导致后续测试的数据库连接失效，进而引发断言失败。

解决方案 #

修改抽象测试类，添加Testcontainers的生命周期管理注解：

@Slf4j
@Testcontainers
public abstract class AbstractTestcontainersTest {

    private final static String DATABASE_NAME = "test_name";

    @Container
    public static final PostgreSQLContainer<?> postgresContainer = new PostgreSQLContainer<>("postgres:12")
            .withReuse(true)
            .withDatabaseName(DATABASE_NAME);

    static {
        postgresContainer.start();
      
    }

    @DynamicPropertySource
    public static void overrideProps(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", postgresContainer::getJdbcUrl);
        registry.add("spring.datasource.username", postgresContainer::getUsername);
        registry.add("spring.datasource.password", postgresContainer::getPassword);
        registry.add("spring.datasource.driver-class-name", postgresContainer::getDriverClassName);

    }
}

关键修改点 #

• @Testcontainers：启用Testcontainers的Spring测试扩展，让Testcontainers参与测试的生命周期管理。
• @Container：标记容器实例由Testcontainers管理，确保测试上下文初始化/刷新时，动态属性能正确获取容器的最新配置，即使容器被复用也能保证连接信息准确。

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