Azure Pipeline中Testcontainers容器删除超时1小时问题求助

问题概述 #

使用.NET 8结合xUnit与Testcontainers进行集成测试，为3个测试文件分别通过ClassFixture创建对应的MsSql Docker容器，本地运行测试完全正常。但在Azure Pipeline中测试会随机失败，表现为删除容器时耗时1小时并触发超时错误。已尝试调试、更换不同版本的Ubuntu代理，但问题仍随机出现。

可行的排查与修复方案 #

1. 优化容器生命周期管理 #

• 替换ClassFixture为CollectionFixture，让多个测试类共享同一个MsSql容器实例，减少容器创建和销毁的次数，降低Pipeline环境的资源竞争
• 在Fixture的销毁逻辑中主动控制容器停止和删除的超时时间，避免依赖Testcontainers的默认清理逻辑：

  public async ValueTask DisposeAsync()
  {
      if (_container is not null)
      {
          await _container.StopAsync(TimeSpan.FromMinutes(2)).ConfigureAwait(false);
          await _container.DeleteAsync(TimeSpan.FromMinutes(2)).ConfigureAwait(false);
      }
  }
  

2. 调整Azure Pipeline代理配置 #

• 为Pipeline分配更高配置的代理实例（增加CPU、内存），资源受限会导致Docker容器操作延迟
• 使用专用自托管代理替代微软托管的共享代理，避免其他任务抢占资源干扰容器操作

3. 修复Testcontainers配置问题 #

• 升级Testcontainers到最新稳定版本，旧版本存在Docker API调用超时的已知bug
• 在容器构建时显式配置Docker API超时和端点：

  var container = new MsSqlBuilder()
      .WithImage("mcr.microsoft.com/mssql/server:2022-latest")
      .WithTimeout(TimeSpan.FromMinutes(5))
      .WithDockerEndpoint(new Uri("unix:///var/run/docker.sock")) // Ubuntu代理使用Unix socket
      .Build();
  

4. 清理Pipeline代理的Docker环境 #

• 在测试步骤前添加Docker环境检查和清理命令，确保环境正常：

  # 检查Docker状态
  docker info
  # 清理残留容器、镜像和缓存
  docker system prune -af --volumes
  

5. 禁用xUnit并行测试 #

• 在项目根目录添加xunit.runner.json，禁用测试集合并行执行，避免多个容器操作同时调用Docker API导致阻塞：

  {
    "parallelizeTestCollections": false,
    "maxParallelThreads": 1
  }
  

6. 增加Pipeline日志排查 #

• 在测试步骤中添加容器操作的详细日志，便于定位超时环节：

  _container = new MsSqlBuilder()
      .WithImage("mcr.microsoft.com/mssql/server:2022-latest")
      .WithLogger(new CustomLogger()) // 自定义日志类输出容器操作细节
      .Build();
  

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