如何在 Selenium Grid 中正确启用文件下载功能-java教程-PHP中文网

如何在 Selenium Grid 中正确启用文件下载功能

本文详解 se:downloadsEnabled 能力的使用前提与配置要点：该能力仅在 Grid 节点显式启用 --enable-managed-downloads 时才生效，否则会因会话匹配失败导致 SessionNotCreatedException。

本文详解 `se:downloadsenabled` 能力的使用前提与配置要点：该能力仅在 grid 节点显式启用 `--enable-managed-downloads` 时才生效，否则会因会话匹配失败导致 `sessionnotcreatedexception`。

se:downloadsEnabled 是 Selenium 4 Grid 引入的服务端托管下载（managed downloads）能力，用于安全、可追溯地管理测试会话中的文件下载行为。但它不是浏览器端的普通 capability——它是一个 Grid 层面的会话路由策略标记。当你在客户端代码中设置：

options.setCapability("se:downloadsEnabled", true);

Selenium Grid 会将该会话请求仅路由到已启动时明确开启托管下载支持的节点上。若所有节点均未启用 --enable-managed-downloads，Grid 将无法匹配任何可用节点，最终抛出 SessionNotCreatedException（错误信息中“browser start-up failure”实为会话调度失败的笼统提示）。

✅ 正确配置流程如下：

启动 Grid Node 时必须添加参数：

java -jar selenium-server-4.9.0.jar node \
  --hub http://localhost:4444/grid/register \
  --enable-managed-downloads true \
  --publish-events tcp://*:4442 \
  --subscribe-events tcp://*:4443

⚠️ 注意：--enable-managed-downloads true 是强制要求，缺省值为 false，且不支持通过环境变量或配置文件替代。

客户端代码中设置 capability（你已做对）：

ChromeOptions options = new ChromeOptions();
options.setCapability("platformName", "LINUX");
options.setCapability("se:downloadsEnabled", true); // ✅ 必须与节点配置一致
// 下载路径偏好仍需保留（但由 Grid 自动注入，无需手动指定 dir）
HashMap<string object> prefs = new HashMap();
prefs.put("download.prompt_for_download", false);
prefs.put("download.directory_upgrade", true);
prefs.put("safebrowsing.enabled", false);
options.setExperimentalOption("prefs", prefs);
driver = new RemoteWebDriver(new URL("http://localhost:4444/"), options);</string>

验证与使用：

下载文件后，可通过 Grid 提供的 HTTP API 获取文件列表与内容：

# 列出当前 session 的所有下载文件
curl -X GET "http://localhost:4444/session/{session-id}/se/download"
# 下载指定文件（返回二进制流）
curl -X GET "http://localhost:4444/session/{session-id}/se/download/{filename}"