使用Testcontainers的XUnit测试遇Docker登录认证错误求解决

以下是使用.NET Testcontainers库编写的XUnit单元测试代码：

using DotNet.Testcontainers.Builders;
using DotNet.Testcontainers.Containers;
using Xunit;

namespace Property.SERVICE.UnitTests
{
    public class TestApiContainerTests : IAsyncLifetime
    {
        private readonly IContainer _container;

        public TestApiContainerTests()
        {
            var foo = CommonDirectoryPath.GetSolutionDirectory();

            var futureImage = new ImageFromDockerfileBuilder()
                .WithDockerfileDirectory(foo, "src")
                .WithDockerfile("Dockerfile")
                .Build();

            futureImage.CreateAsync();

            _container = new ContainerBuilder()                
                .WithImage(futureImage)                
                .WithPortBinding(8080, true)                
                .WithWaitStrategy(Wait.ForUnixContainer().UntilHttpRequestIsSucceeded(r => r.ForPort(8080)))                
                .Build();
        }        
    }
}

错误描述 #

构建自定义镜像并启动容器时，抛出Docker.DotNet.DockerApiException异常，Docker API返回状态码ProxyAuthenticationRequired，提示信息为："Please run 'docker login'"。已在终端执行docker login并显示登录成功，但重新运行测试仍报相同错误。

解决方法 #

• 核对Docker上下文一致性：终端执行docker login的用户上下文，可能和运行测试的进程（比如IDE）使用的上下文不一致。检查运行测试的用户是否能访问终端登录生成的Docker配置文件（路径通常为~/.docker/config.json或%USERPROFILE%/.docker/config.json），确保两者使用同一套Docker配置。
• 显式配置Testcontainers的Docker客户端：在代码中指定Docker客户端的配置，确保它使用正确的认证信息：

  // 初始化Docker客户端配置，Windows环境可替换为npipe:////./pipe/docker_engine
  var dockerConfig = new DockerClientConfiguration(new Uri("unix:///var/run/docker.sock"));
  var dockerClient = dockerConfig.CreateClient();
  
  var futureImage = new ImageFromDockerfileBuilder()
      .WithDockerfileDirectory(foo, "src")
      .WithDockerfile("Dockerfile")
      .WithDockerClient(dockerClient) // 传递配置好的客户端
      .Build();
  

• 检查Docker代理配置：如果环境依赖代理，确认Docker daemon的代理配置是否正确包含认证信息。终端的代理环境变量不会自动同步到Docker daemon，需要手动在Docker daemon配置文件（如/etc/docker/daemon.json）中设置代理及认证：

  {
    "proxies": {
      "default": {
        "httpProxy": "http://user:password@proxy.example.com:8080",
        "httpsProxy": "http://user:password@proxy.example.com:8080"
      }
    }
  }
  

  修改后重启Docker daemon生效。
• 同步认证配置到测试进程的用户目录：如果测试以管理员身份运行，而终端登录的是普通用户，可将普通用户目录下的.docker/config.json复制到管理员用户的对应目录下，确保测试进程能读取到认证信息。
• 修复异步调用未等待的问题：原代码中调用futureImage.CreateAsync()但未使用await，可能导致镜像构建未完成就执行后续操作，引发异常。按照IAsyncLifetime规范修改初始化逻辑：

  public async Task InitializeAsync()
  {
      var foo = CommonDirectoryPath.GetSolutionDirectory();
  
      var futureImage = new ImageFromDockerfileBuilder()
          .WithDockerfileDirectory(foo, "src")
          .WithDockerfile("Dockerfile")
          .Build();
  
      await futureImage.CreateAsync();
  
      _container = new ContainerBuilder()                
          .WithImage(futureImage)                
          .WithPortBinding(8080, true)                
          .WithWaitStrategy(Wait.ForUnixContainer().UntilHttpRequestIsSucceeded(r => r.ForPort(8080)))                
          .Build();
  
      await _container.StartAsync();
  }
  
  public async Task DisposeAsync()
  {
      await _container.StopAsync();
      await _container.DisposeAsync();
  }
  

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