You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Selenium 4 Firefox下载PDF自动打开新标签页问题求助

解决Selenium 4 + Firefox 116下载PDF时在新标签页打开的问题

针对你遇到的问题,核心是Firefox的偏好配置有误,加上Selenium 4的配置传递方式需要调整,以下是修正方案:

关键配置修正

你的现有配置中存在错误的偏好设置,同时缺少必要的下载目录配置,调整后的完整配置如下:

FirefoxOptions firefoxOptions = new FirefoxOptions();

// 禁用Firefox内置PDF查看器(核心)
firefoxOptions.addPreference("pdfjs.disabled", true);
// 指定PDF类型直接保存,不弹出询问
firefoxOptions.addPreference("browser.helperApps.neverAsk.saveToDisk", "application/pdf");
// 隐藏下载面板
firefoxOptions.addPreference("browser.download.panel.shown", false);
// 不显示下载管理器启动提示
firefoxOptions.addPreference("browser.download.manager.showWhenStarting", false);
// 强制PDF触发下载而非在浏览器内打开
firefoxOptions.addPreference("plugins.always_open_pdf_externally", true);
// 禁用PDF全页插件
firefoxOptions.addPreference("plugin.disable_full_page_plugin_for_types", "application/pdf");

// 可选:指定自定义下载目录(建议添加,避免默认路径问题)
firefoxOptions.addPreference("browser.download.folderList", 2); // 2代表自定义目录
firefoxOptions.addPreference("browser.download.dir", "/path/to/your/download/folder"); // Windows环境替换为"C:\\xxx"格式路径

配置传递方式修正

你之前的代码创建了两个FirefoxOptions对象并嵌套到cloud:options中,普通Selenium Grid场景下完全多余,直接传递配置好的FirefoxOptions即可:

// 直接使用配置完成的FirefoxOptions初始化RemoteWebDriver
RemoteWebDriver remoteWebDriver = new RemoteWebDriver(new URL("your-remote-url"), firefoxOptions);

如果你的场景确实需要使用cloud:options(比如云测试平台),请修正变量名笔误并确保嵌套结构正确:

FirefoxOptions ffop = new FirefoxOptions();
// 这里添加上述修正后的偏好配置...

Map<String, Object> capabilities = new HashMap<>();
capabilities.put("moz:firefoxOptions", ffop);

FirefoxOptions firefoxOptions = new FirefoxOptions();
firefoxOptions.setCapability("cloud:options", capabilities);

RemoteWebDriver remoteWebDriver = new RemoteWebDriver(new URL("your-cloud-url"), firefoxOptions);

配置说明

  • plugins.always_open_pdf_externally设为true是解决问题的核心,之前设为false会让Firefox尝试用内置或插件打开PDF
  • Selenium 4中已移除useAutomationExtension相关扩展,该配置项可直接删除
  • 添加自定义下载目录能避免Firefox因路径不确定而 fallback 到打开PDF的行为

内容的提问来源于stack exchange,提问作者WarzoneSpecialist

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.10 06:05:28