Testcontainers-dotnet 项目中的 Cosmos DB 容器 SSL 连接问题分析与解决方案

问题背景

在使用 Testcontainers-dotnet 项目进行 Cosmos DB 容器测试时，开发人员遇到了 SSL 连接无法建立的问题。这个问题主要出现在测试代码尝试连接 Cosmos DB 模拟器容器时，系统抛出 SSL 连接异常。

问题现象

当测试代码尝试初始化 Cosmos DB 容器并建立连接时，会出现以下错误：

System.Net.Http.HttpRequestException: The SSL connection could not be established, see inner exception.

错误表明 SSL 连接无法建立，这通常与证书验证失败或容器尚未完全初始化有关。

根本原因分析

经过深入调查，发现问题的根源在于：

1. 容器启动时序问题：Cosmos DB 模拟器容器需要较长时间才能完全初始化并准备好接受连接，而测试代码在容器尚未完全就绪时就尝试建立连接。

2. 证书验证机制：Cosmos DB 客户端没有使用测试代码中提供的自定义 HTTP 客户端，导致证书验证失败。

3. 镜像变更影响：虽然测试容器模块本身没有变化，但底层使用的 Cosmos DB 镜像可能发生了更新，导致行为变化。

解决方案

针对这个问题，社区提出了几种有效的解决方案：

1. 自定义等待策略

开发一个专门的等待策略，确保容器完全初始化后再继续测试：

private sealed class WaitUntil : IWaitUntil
{
    public async Task<bool> UntilAsync(IContainer container)
    {
        const string requestUri = "https://localhost/_explorer/emulator.pem";
        var httpClient = ((CosmosDbContainer)container).HttpClient;

        try
        {
            using var httpResponse = await httpClient.GetAsync(requestUri)
                .ConfigureAwait(false);
            return httpResponse.IsSuccessStatusCode;
        }
        catch (Exception)
        {
            return false;
        }
        finally
        {
            httpClient.Dispose();
        }
    }
}

2. 容器配置优化

在构建容器时应用等待策略：

this.container = new CosmosDbBuilder()
    .WithPrivileged(true)
    .WithExposedPort(CosmosDbBuilder.CosmosDbPort)
    .WithCleanUp(true)
    .WithWaitStrategy(Wait.ForUnixContainer()
        .AddCustomWaitStrategy(new CosmosWaitStrategy()))
    .Build();

3. 使用特定版本的镜像

对于新版 Cosmos DB 模拟器镜像，需要进行特定的环境变量配置：

Container = new CosmosDbBuilder()
    .WithImage("mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:vnext-preview")
    .WithEnvironment("AZURE_COSMOS_EMULATOR_PARTITION_COUNT", "3")
    .WithEnvironment("AZURE_COSMOS_EMULATOR_ENABLE_DATA_PERSISTENCE", "true")
    .WithExposedPort(8081)
    .WithPortBinding(8081, true)
    .WithWaitStrategy(Wait
        .ForUnixContainer()
        .AddCustomWaitStrategy(new CosmosDbContainerWaitStrategy()))
    .Build();

最佳实践建议

1. 充分的等待时间：Cosmos DB 模拟器容器初始化可能需要较长时间，确保测试代码中有足够的等待机制。

2. 健壮的错误处理：在连接尝试中加入适当的重试逻辑和错误处理，应对容器启动过程中的临时性问题。

3. 版本控制：明确指定使用的容器镜像版本，避免因镜像更新带来的意外行为变化。

4. 健康检查：实现完善的健康检查机制，确保容器服务完全就绪后再进行测试。

总结

Testcontainers-dotnet 项目中 Cosmos DB 容器的 SSL 连接问题是一个典型的容器初始化时序问题。通过实现自定义等待策略和优化容器配置，可以有效解决这个问题。这个案例也提醒我们，在使用容器化测试环境时，必须考虑服务初始化的异步特性，并建立相应的等待和健康检查机制，确保测试的可靠性和稳定性。