解决 ChromeDriver 端口指定难题 | Selenium 测试

2025-02-08 06:01:33

解决 ChromeDriver 端口指定问题

ChromeDriver 默认会在一个随机端口上启动，有时这会与系统环境或组织安全策略相冲突，导致无法建立连接或者出现 "Cannot assign requested address" 错误。特别是像在具有端口限制的环境中使用 Selenium Grid 时，就需要明确指定 ChromeDriver 启动的端口。下面介绍几种指定 ChromeDriver 端口的解决方案。

问题分析

观察报错信息：

Starting ChromeDriver 74.0.3729.6 (255758eccf3d244491b8a1317aa76e1ce10d57e9-refs/branch-heads/3729@{#29}) on port 3459
...
[1567550645.675][SEVERE]: bind() failed: Cannot assign requested address (99)

这段信息表明 ChromeDriver 试图绑定一个随机端口(这里是 3459)，但由于端口可能被占用或无权访问，导致绑定失败。这在服务器环境或者存在端口限制的网络中非常常见。

解决方案

通常有两种方式可以解决该问题：在 ChromeDriver 启动时指定端口，或调整系统设置以允许 ChromeDriver 访问所需端口。

方案一：ChromeDriver 启动参数指定端口

可以直接在 ChromeOptions 中添加 --port 参数来控制 ChromeDriver 监听的端口。需要注意的是，这个方法可能不会直接影响ChromeDriver所使用的端口，而是可能配置 Chrome 浏览器内部通信使用的端口。尽管如此，尝试设置仍然有意义，看看它是否能间接解决端口冲突的问题。

操作步骤和代码示例：

在创建 ChromeOptions 时，添加 --port 参数。

ChromeOptions chromeOptions = new ChromeOptions();
chromeOptions.addArguments(
        "--verbose",
        "--headless",
        "--disable-web-security",
        "--ignore-certificate-errors",
        "--allow-running-insecure-content",
        "--allow-insecure-localhost",
        "--no-sandbox",
        "--disable-gpu",
        "--port=4040"); // 指定ChromeDriver 使用 4040 端口

注意将 4040 替换成希望ChromeDriver 尝试使用的端口号。然后，将此 ChromeOptions 传递给 RemoteWebDriver。

driver = new RemoteWebDriver(new URL(nodeURL), chromeOptions);

再次运行测试，观察 ChromeDriver 是否尝试使用指定端口启动。如果此方法不起作用，可能需要考虑其他方法。值得注意的是，由于Selenium和ChromeDriver的版本差异，这种方法的效果可能有所不同，在最新的版本中, 可能无法强制指定ChromeDriver的监听端口。

方案二：使用 ChromeDriverService 指定端口（推荐）

ChromeDriverService 提供了更直接的方法来指定 ChromeDriver 进程使用的端口。这是一个更可靠的指定端口的方法。

操作步骤和代码示例：

构建 ChromeDriverService 对象，并指定端口。

import org.openqa.selenium.chrome.ChromeDriverService;
import java.io.File;
import java.io.IOException;

ChromeDriverService service = new ChromeDriverService.Builder()
            .usingDriverExecutable(new File("~/chromedriver")) // ChromeDriver 可执行文件的路径
            .usingPort(4040) // 指定端口
            .build();
    try {
        service.start();
    } catch (IOException e) {
        e.printStackTrace();
    }

确认已经将 chromedriver 的路径添加到了 PATH 环境变量中。

使用该 Service 构建 ChromeOptions 和 RemoteWebDriver。

ChromeOptions options = new ChromeOptions();
options.addArguments(
            "--verbose",
            "--headless",
            "--disable-web-security",
            "--ignore-certificate-errors",
            "--allow-running-insecure-content",
            "--allow-insecure-localhost",
            "--no-sandbox",
            "--disable-gpu");

driver = new RemoteWebDriver(service.getUrl(), options); // 使用 service.getUrl() 获取 ChromeDriver 的 URL

关闭 ChromeDriverService，测试完成后停止服务，释放端口。
```
driver.quit();
service.stop();
```

这个步骤非常重要，可以防止资源泄露和端口占用问题。

这种方式更加直接，也更能保证 ChromeDriver 按照预期使用指定的端口启动。

方案三：服务器防火墙或安全组配置（适用于云服务器）

如果使用云服务器（如 AWS EC2），确保服务器的安全组或防火墙规则允许传入和传出流量通过ChromeDriver尝试使用的端口。

操作步骤和示例：

登录云服务器管理控制台（如 AWS Console）。
找到与 EC2 实例关联的安全组。
添加一个入站规则，允许 TCP 流量从任何来源 (或者指定的 IP 范围) 访问指定端口（例如 4040）。
添加一个出站规则，允许 TCP 流量到任何目的地（或者指定的 IP 范围）通过指定端口（例如 4040）。

安全组规则的配置取决于具体的云平台。正确的配置是保证 ChromeDriver 能正常工作的关键。

方案四：检查 Chrome 浏览器和 ChromeDriver 版本

"unknown error: cannot find Chrome binary" 这个错误通常是由于 ChromeDriver 的版本与 Chrome 浏览器版本不兼容引起的。确保使用的 ChromeDriver 版本与 Chrome 浏览器版本兼容。

操作步骤和示例：

确认 Chrome 浏览器的版本。在 Chrome 浏览器中，点击“帮助”->“关于 Google Chrome”即可查看版本信息。
下载与 Chrome 浏览器版本相匹配的 ChromeDriver。可以从 ChromeDriver 的官方网站下载： ChromeDriver Releases 。

ChromeDriver 版本与 Chrome 浏览器版本不匹配会导致各种奇怪的问题，因此请务必确保版本兼容。

额外的安全建议

限制 ChromeDriver 的访问权限 : 始终限制 ChromeDriver 监听端口的访问权限，避免恶意代码利用。可以通过配置防火墙或使用安全组规则来实现。
及时更新 : 保持 Chrome 浏览器、ChromeDriver 和 Selenium 库更新到最新版本，以修复安全漏洞并获得性能提升。
监控资源使用情况 : 定期监控服务器的资源使用情况，特别是 CPU、内存和网络端口，及时发现并解决潜在的问题。
不要使用 root 用户启动 Selenium Grid : 使用普通用户启动 Selenium Grid，降低安全风险。