如何将Testcontainers可复用容器方案从2.4.0迁移至3.4.0？

核心API变化说明 #

• 移除了ContainerBuilder<T>，改用各容器专属的Builder（如PostgresBuilder、MySqlBuilder）或GenericContainer的链式配置方式
• TestcontainerDatabase被拆分为数据库专属容器类（如PostgresContainer），复用配置直接整合到Builder中

解决额外容器生成与自动销毁问题 #

关键原因 #

升级后出现的testcontainers容器是Ryuk容器，Testcontainers 3.x默认启用它来自动清理测试结束后的所有容器，这直接破坏了复用逻辑。同时，3.x版本的复用机制需要显式全局开启，否则即使设置容器复用也不生效。

具体适配步骤 #

1. 全局启用复用配置
   在测试项目初始化阶段（如测试类的静态构造函数、启动入口）添加全局复用开关：

   // .NET 示例，Java 对应设置系统属性 testcontainers.reuse.enable=true
   TestcontainersSettings.Instance.EnableReuse = true;
   

2. 替换容器构建逻辑
   弃用原ContainerBuilder<T>，改用3.x的专属Builder，并显式启用复用、禁用Ryuk：

   // 原2.4.0代码（示例）
   // var container = new ContainerBuilder<PostgresTestcontainer>()
   //     .WithDatabase(new PostgresTestcontainerConfiguration { ... })
   //     .WithReuse(true)
   //     .Build();
   
   // 3.4.0适配代码
   var container = new PostgresBuilder()
       .WithDatabase("testdb")
       .WithUsername("testuser")
       .WithPassword("testpass")
       .WithReuse(true) // 启用容器复用
       .WithoutRyuk()   // 禁用自动清理的Ryuk容器
       .WithName("reusable-test-postgres") // 设置唯一名称，避免复用冲突
       .Build();
   

3. 手动管理容器生命周期
   不要依赖测试框架的自动销毁逻辑（如IClassFixture的自动Dispose），手动控制容器启动：

   // 在测试类初始化时启动容器，测试结束后不要调用StopAsync/Dispose
   await container.StartAsync();
   

注意事项 #

• 确保Docker守护进程允许容器长期运行，没有配置自动清理策略
• 复用容器的名称必须唯一，避免不同测试用例的容器冲突
• 如果是Java环境，对应配置为：设置系统属性testcontainers.reuse.enable=true，容器构建时调用withReuse(true)并添加disableRyuk()配置

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