Testcontainers的Ryuk容器无法停止单例PostgreSQL容器问题问询

容器未被自动回收的核心原因是配置了.withReuse(true)。
Testcontainers的容器复用模式设计目标是跨测试套件、跨JVM实例保留运行中的容器，减少重复启动容器的等待时间。开启该配置后，Testcontainers会主动通知Ryuk跳过对该容器的生命周期回收，无论测试是否执行完成、JVM是否退出，容器都会持续在后台运行。
你当前通过静态代码块实现的基类加载即启动容器的模式，已经可以实现同一次测试执行流程中、所有继承该基类的测试类复用同一个容器的效果，这个能力完全不需要开启Reuse模式即可实现。

根据你的使用场景选择对应方案即可：

场景1：仅需单次测试执行流程内复用容器（CI环境、常规自动化测试场景选这个） #

直接删除容器配置中的.withReuse(true)代码即可，修改后的静态初始化块代码如下：

static {
    postgresSQLContainer = new PostgreSQLContainer<>("postgres:14")
            .withUsername("test")
            .withPassword("test")
            .withInitScript("sql/init.sql")
            .withDatabaseName("test");

    postgresSQLContainer.start();
}

修改后效果：

• 同一次测试任务执行时，Postgres容器仅启动一次，所有继承基类的测试类共用该容器，完全满足单例复用需求
• 测试套件执行完成、JVM退出后，Ryuk会在默认10秒超时后自动停止并删除该容器，不会残留

场景2：需要跨测试运行复用容器（本地开发场景选这个） #

这种场景下Ryuk不回收容器是符合设计预期的行为，你需要手动管理容器清理：

• 首先确认本地用户目录下的.testcontainers.properties文件中已开启全局复用配置：

  testcontainers.reuse.enable=true
  

• 定期执行以下Docker命令批量清理残留的Testcontainers容器，避免占用内存和磁盘空间：

  # 停止并删除所有Testcontainers启动的Postgres 14容器
  docker rm -f $(docker ps -aq --filter "label=org.testcontainers" --filter "ancestor=postgres:14")
  

• 不要混淆静态单例容器和Reuse模式的适用范围：静态单例是JVM进程级别的复用，测试结束容器自动回收，适合CI环境；Reuse模式是跨进程、跨测试运行的复用，容器默认不回收，仅适合本地开发提效，禁止在CI环境开启Reuse模式，否则会导致CI节点堆积大量残留容器耗尽磁盘空间。
• 如果移除.withReuse(true)配置后容器依然残留，将Testcontainers版本升级到1.17+即可，旧版本存在Ryuk偶发不回收容器的Docker兼容问题。

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