Testcontainers-dotnet 4.0.0版本中的容器注册表凭证解析问题解析

在Testcontainers-dotnet 4.0.0版本中，用户报告了一个关于容器注册表凭证解析的重要回归问题。这个问题主要影响使用自定义容器注册表并设置了TESTCONTAINERS_HUB_IMAGE_NAME_PREFIX环境变量的场景。

问题背景

Testcontainers-dotnet是一个流行的.NET库，用于在测试环境中管理容器。许多团队会配置自定义的容器注册表来缓存公共镜像，如公共镜像仓库中的镜像，以提高拉取速度和可靠性。

在4.0.0版本之前，当用户配置了自定义注册表前缀（如"our.selfhosted.registry/containerhub"）时，系统能够正确地从环境变量DOCKER_AUTH_CONFIG中解析出注册表凭证。然而，在升级到4.0.0版本后，这一功能出现了问题。

问题表现

当用户尝试使用自定义注册表前缀时，系统无法正确匹配注册表凭证。日志显示类似以下错误：

容器注册表凭证 our.selfhosted.registry/containerhub not found

而实际上，凭证配置是正确的，格式如下：

{"auths":{"https://our.selfhosted.registry":{"auth":"bXlfdXNlcm5hbWU6bXlfcGFzc3dvcmQ="}}}

根本原因

经过深入分析，发现问题出在DockerImage类的构造函数中。在4.0.0版本中，当使用自定义注册表前缀时，系统错误地将整个前缀（包括命名空间部分）分配给了Registry属性，而不是正确地将其分割为Registry和Repository两部分。

例如，对于前缀"myregistry.azurecr.io/library"：

• 错误行为：Registry = "myregistry.azurecr.io/library", Repository = "postgres"
• 正确行为：Registry = "myregistry.azurecr.io", Repository = "library/postgres"

解决方案

项目维护者迅速响应并提出了修复方案。修复的核心是调整DockerImage类中注册表前缀的处理逻辑，确保正确分割Registry和Repository部分。修复后的版本（4.1.0-beta.11746011829）已经验证可以解决这个问题。

临时解决方案

对于需要立即解决问题的用户，可以考虑以下临时方案：

1. 回退到3.8.0或3.10.0版本
2. 修改DOCKER_AUTH_CONFIG，将注册表路径包含命名空间部分（如"https://our.selfhosted.registry/containerhub"）

最佳实践建议

为了避免类似问题，建议：

1. 在升级前充分测试自定义注册表配置
2. 保持关注项目的发布说明和已知问题
3. 考虑在CI/CD流水线中添加针对自定义注册表的测试用例

这个问题提醒我们，在基础设施工具链升级时，需要特别注意认证和授权相关的功能变更，这些往往是安全性和可用性的关键路径。