Linux与WSL下Go单元测试用Testcontainers的兼容问题求解

问题本质 #

你遇到的topology.ServerSelectionError核心是默认bridge网络下，测试代码无法正确连接MongoDB容器：

• WSL环境禁用Ryuk后正常，是因为Ryuk在WSL的Docker网络环境中存在端口冲突或权限适配问题；
• 强制host网络虽然绕过了bridge的端口映射限制，但Jenkins环境通常有严格的网络隔离规则（比如容器化Jenkins无法直接使用host网络、端口占用冲突），导致构建异常。

统一构建的解决方案 #

1. 用Testcontainers原生方法获取连接端点，放弃硬编码地址 #

不要手动拼接localhost:随机端口，Testcontainers会自动管理端口映射，直接调用容器提供的方法获取正确的连接地址：

// 创建MongoDB容器实例后，获取有效连接端点
endpoint, err := mongoContainer.Endpoint(ctx, "mongodb")
if err != nil {
    log.Fatal(err)
}
// 构造标准MongoDB连接字符串
mongoURI := fmt.Sprintf("mongodb://%s", endpoint)
client, err := mongo.Connect(ctx, options.Client().ApplyURI(mongoURI))

2. 跨环境统一禁用Ryuk #

在所有构建环境（Linux原生、WSL、Jenkins）中设置环境变量TESTCONTAINERS_RYUK_DISABLED=true，避免Ryuk的网络适配问题干扰容器启动：

• 本地测试：终端执行export TESTCONTAINERS_RYUK_DISABLED=true后运行测试；
• Jenkins构建：在Job的环境变量配置中添加该参数。

3. 确保MongoDB容器监听所有网络接口 #

启动MongoDB容器时添加--bind_ip_all参数，避免容器内MongoDB仅监听127.0.0.1导致bridge网络无法访问：

containerReq := testcontainers.ContainerRequest{
    Image:        "mongo:latest",
    Cmd:          []string{"mongod", "--bind_ip_all"},
    ExposedPorts: []string{"27017/tcp"},
    // 移除HostConfigModifier的host网络配置，保留其他必要参数
}

4. Jenkins环境的Docker适配 #

如果Jenkins是容器化部署：

• 确保Jenkins容器挂载Docker套接字（/var/run/docker.sock:/var/run/docker.sock），且拥有足够的操作权限；
• 依赖Testcontainers默认的自定义隔离网络，不要在Jenkins环境中使用host网络，避免端口冲突或权限问题。

验证步骤 #

1. Linux原生环境：移除host网络配置，设置上述环境变量，用Testcontainers端点方法连接MongoDB，验证测试通过；
2. WSL环境：保持相同配置，确认测试正常运行；
3. Jenkins构建：添加环境变量，复用同一套测试代码，确认构建成功。

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