.NET单元测试中如何获取Testcontainers的调试输出

针对你配置Testcontainers日志后无法看到容器启动详情的问题，可通过以下步骤解决：

1. 适配xUnit的ITestOutputHelper #

xUnit默认会重定向控制台输出，直接用AddConsole()无法将Testcontainers日志带到测试输出中。需要实现自定义日志提供器，把日志输出到xUnit的ITestOutputHelper：

自定义日志提供器代码 #

public class TestOutputLoggerProvider : ILoggerProvider
{
    private readonly ITestOutputHelper _testOutput;
    private readonly LogLevel _minLevel;

    public TestOutputLoggerProvider(ITestOutputHelper testOutput, LogLevel minLevel = LogLevel.Debug)
    {
        _testOutput = testOutput;
        _minLevel = minLevel;
    }

    public ILogger CreateLogger(string categoryName)
    {
        return new TestOutputLogger(_testOutput, categoryName, _minLevel);
    }

    public void Dispose() { }
}

public class TestOutputLogger : ILogger
{
    private readonly ITestOutputHelper _testOutput;
    private readonly string _categoryName;
    private readonly LogLevel _minLevel;

    public TestOutputLogger(ITestOutputHelper testOutput, string categoryName, LogLevel minLevel)
    {
        _testOutput = testOutput;
        _categoryName = categoryName;
        _minLevel = minLevel;
    }

    public IDisposable BeginScope<TState>(TState state) => NullScope.Instance;

    public bool IsEnabled(LogLevel logLevel) => logLevel >= _minLevel;

    public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception, Func<TState, Exception, string> formatter)
    {
        if (!IsEnabled(logLevel)) return;

        var message = formatter(state, exception);
        _testOutput.WriteLine($"[{logLevel}] {_categoryName}: {message}");
        exception?.Let(ex => _testOutput.WriteLine($"Exception: {ex}"));
    }

    private class NullScope : IDisposable
    {
        public static readonly NullScope Instance = new();
        public void Dispose() { }
    }
}

在Fixture中配置日志 #

修改你的HaproxyDataplaneFixture，添加接收ITestOutputHelper的方法，并在初始化时配置日志：

public class HaproxyDataplaneFixture : IAsyncLifetime
{
    private ITestOutputHelper _testOutput;
    private IContainer _container;

    // 从测试类接收ITestOutputHelper
    public void SetTestOutput(ITestOutputHelper testOutput)
    {
        _testOutput = testOutput;
    }

    public async Task InitializeAsync()
    {
        // 创建日志工厂，使用自定义提供器
        var loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.SetMinimumLevel(LogLevel.Debug)
                   .AddProvider(new TestOutputLoggerProvider(_testOutput));
        });

        // 设置全局Testcontainers日志
        TestcontainersSettings.Logger = loggerFactory.CreateLogger<HaproxyDataplaneFixture>();

        // 构建容器时开启日志捕获，确保容器stdout/stderr被记录
        var containerBuilder = new ContainerBuilder()
            .WithImage("haproxy:latest")
            .WithPortBinding(80, 8080)
            .WithLogging(new LoggingConfiguration { LogDriver = "json-file" })
            .WithWaitStrategy(Wait.ForUnixContainer().UntilPortIsAvailable(80))
            // 给容器单独指定日志器（可选，更精准）
            .WithLogger(loggerFactory.CreateLogger<IContainer>());

        _container = containerBuilder.Build();
        await _container.StartAsync();
    }

    public async Task DisposeAsync()
    {
        await _container.StopAsync();
        await _container.DisposeAsync();
    }
}

在测试类中传递ITestOutputHelper #

public class HaproxyTests : IClassFixture<HaproxyDataplaneFixture>
{
    private readonly HaproxyDataplaneFixture _fixture;

    public HaproxyTests(HaproxyDataplaneFixture fixture, ITestOutputHelper output)
    {
        _fixture = fixture;
        // 把输出助手传给Fixture
        _fixture.SetTestOutput(output);
    }

    [Fact]
    public async Task TestHaproxyConnection()
    {
        // 测试逻辑...
    }
}

2. 调整命令行运行参数 #

用dotnet test命令时，添加详细日志参数，确保控制台能输出完整日志：

dotnet test --logger "console;verbosity=detailed"

3. VS输出窗口设置 #

在Visual Studio中：

• 打开「输出」窗口，选择「显示输出来自：测试」
• 点击输出窗口右上角的「详细程度」下拉菜单，选择「详细」

4. 验证日志输出 #

可以故意用一个不存在的镜像（比如haproxy:invalid-tag）启动容器，触发错误，此时应该能看到Testcontainers的详细错误日志，包括镜像拉取失败、容器启动失败等信息。

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