容器内用WebDriverManager的browserInDocker()运行测试遇连接拒绝问题

1. localhost映射逻辑冲突：browserInDocker()默认会把浏览器容器的4444端口映射到测试容器的随机本地端口（比如你看到的50967），并让WebDriver连接http://localhost:端口/wd/hub。但容器内的localhost指向测试容器自身，而非浏览器容器，因此触发连接拒绝错误。
2. 封装逻辑限制：该方法内部封装了容器启动与WebDriver会话绑定的流程，强制使用映射后的本地端口地址，会忽略手动设置的RemoteAddress；同时没有提供直接获取浏览器容器内部IP的API，导致无法利用Docker内部网络直接建立连接。

方案1：自定义Docker网络+容器名称访问（推荐） #

此方式不依赖动态IP，稳定性更强：

• 先创建自定义桥接网络：

  docker network create test-browser-network
  

• 启动测试容器时加入该网络：

  docker run --network test-browser-network -v $(pwd):/app -w /app maven:3.8.6-openjdk-11 mvn test
  

• 在测试代码中给浏览器容器指定固定名称，手动构建RemoteWebDriver连接容器名称地址：

  DockerOptions dockerOptions = new DockerOptions()
          .setImage("selenoid/vnc:firefox_106.0")
          .setContainerName("firefox-test-container")
          .setNetwork("test-browser-network");
  
  // 启动浏览器容器
  WebDriverManager.firefoxdriver().docker(dockerOptions).create();
  
  // 连接容器名称对应的内部地址
  WebDriver driver = new RemoteWebDriver(new URL("http://firefox-test-container:4444/wd/hub"), new FirefoxOptions());
  

方案2：获取浏览器容器内部IP并连接 #

利用WebDriverManager底层的Docker Java客户端，获取容器内部IP：

DockerOptions dockerOptions = new DockerOptions()
        .setImage("selenoid/vnc:firefox_106.0");

WebDriverManager driverManager = WebDriverManager.firefoxdriver().docker(dockerOptions);
driverManager.create();

// 获取已启动的浏览器容器
DockerClient dockerClient = driverManager.getDockerClient();
List<Container> containers = dockerClient.listContainersCmd()
        .withLabel("webdrivermanager.name", driverManager.getDockerOptions().getImage())
        .exec();

if (!containers.isEmpty()) {
    Container container = containers.get(0);
    // 提取容器在Docker内部网络的IP
    String containerIp = container.getNetworkSettings().getNetworks().values().iterator().next().getIpAddress();
    // 手动创建WebDriver连接内部IP
    WebDriver driver = new RemoteWebDriver(new URL("http://" + containerIp + ":4444/wd/hub"), new FirefoxOptions());
}

方案3：测试容器使用host网络（简易但有局限性） #

若环境允许，启动测试容器时使用--network host模式，此时测试容器的localhost会指向宿主机，可直接访问浏览器容器映射的端口：

docker run --network host -v $(pwd):/app -w /app maven:3.8.6-openjdk-11 mvn test

注意：该模式在Windows/macOS的Docker Desktop中兼容性有限，且会将容器端口暴露到宿主机，安全性稍弱。

browserInDocker()最初是为本地开发场景设计的，默认逻辑未考虑容器内运行测试的网络隔离问题，官方未明确标注支持该场景，但通过上述自定义配置的方式，可以适配容器内运行的需求。后续版本可能会优化网络配置的灵活性，当前需通过手动扩展实现。

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