如何使用Selenium在无头Firefox浏览器中实现文件下载

结论 #

你提供的正常模式配置无法直接在Firefox无头模式下生效，无头模式默认会屏蔽部分下载弹窗相关的偏好设置，需要补充额外参数才能正常运行。

具体操作步骤 #

1. 补充必填偏好配置 #

在原有prefs基础上，新增4项配置：

• browser.download.manager.showWhenStarting：设为false，关闭下载管理器启动弹窗
• browser.download.manager.useWindow：设为false，禁止下载管理器弹出独立窗口
• browser.helperApps.alwaysAsk.force：设为false，强制跳过文件类型确认询问
• browser.download.avoidOpeningSystemDialog：设为true，适配Firefox 94+版本，禁止调用系统下载弹窗

2. 校验原有配置项 #

• browser.helperApps.neverAsk.saveToDisk：值必须和你下载文件的MIME类型完全匹配，多类型用英文逗号分隔，可添加application/octet-stream作为二进制文件兜底
• browser.download.dir：必须使用绝对路径，且保证Selenium运行进程对该路径有读写权限

3. 正确设置无头模式参数 #

使用新版无头模式启动参数--headless=new，旧版无头模式--headless兼容性较差，容易出现配置不生效问题

完整配置示例 #

"moz:firefoxOptions": {
  "args": ["--headless=new"],
  "prefs": {
    "browser.helperApps.neverAsk.saveToDisk": "text/calendar,application/octet-stream",
    "browser.download.folderList": 2,
    "browser.download.dir": "/tmp",
    "browser.download.manager.showWhenStarting": false,
    "browser.download.manager.useWindow": false,
    "browser.helperApps.alwaysAsk.force": false,
    "browser.download.avoidOpeningSystemDialog": true
  }
}

问题排查 #

如果配置后仍然无法下载，按以下顺序排查：

• 先在正常模式下测试配置，排除MIME类型错误、路径无权限等基础问题
• 确认GeckoDriver和Firefox版本匹配，跨大版本会出现偏好配置不兼容问题
• 特殊格式文件可添加browser.download.saveLinkAsFilenameTimeout: 4000配置，延长文件名识别等待时长

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