
chrome 升级至 117 版本后,selenium 默认触发系统级“save as”对话框,导致自动化下载中断;根本原因在于新版 chrome 加强了自动下载策略限制,需同步调整浏览器配置、驱动兼容性及关键启动参数。
chrome 升级至 117 版本后,selenium 默认触发系统级“save as”对话框,导致自动化下载中断;根本原因在于新版 chrome 加强了自动下载策略限制,需同步调整浏览器配置、驱动兼容性及关键启动参数。
自 Chrome 117 起,Google 引入更严格的自动下载管控机制(尤其在隐身模式下),即使已正确配置 download.prompt_for_download=false,若存在冲突参数或策略未显式禁用,仍会回退至操作系统级保存对话框。以下是经过验证的完整修复方案:
✅ 关键修正点(Java 示例)
首先,必须移除 --incognito 参数——这是 Chrome 117+ 中导致下载策略失效的最常见原因。隐身模式会忽略用户偏好设置(包括下载路径与提示行为),强制启用安全保护逻辑。
其次,确保偏好设置使用标准键名,并启用必要策略:
ChromeOptions chromeOptions = new ChromeOptions();
String downloadDir = Paths.get("downloads").toAbsolutePath().toString();
// ⚠️ 移除以下这行(关键!)
// chromeOptions.addArguments("--incognito");
// 必须启用远程调试兼容(Chrome 117+ 强制要求)
chromeOptions.addArguments("--remote-allow-origins=*");
// 下载偏好设置(注意:key 名为 "download.directory_upgrade",非 "directory_upgrade")
Map<String, Object> prefs = new HashMap<>();
prefs.put("download.default_directory", downloadDir);
prefs.put("download.prompt_for_download", false);
prefs.put("download.directory_upgrade", true); // ✅ 正确拼写
prefs.put("safebrowsing.enabled", false); // 推荐设为 false(布尔值,非字符串)
prefs.put("plugins.always_open_pdf_externally", true);
chromeOptions.setExperimentalOption("prefs", prefs);
// 其他参数保持不变(如 --ignore-certificate-errors 等可保留)
WebDriver driver = new ChromeDriver(chromeOptions);? 浏览器端辅助配置(推荐双保险)
即使代码配置正确,Chrome 的全局策略仍可能覆盖 WebDriver 设置。请手动验证并关闭以下选项:
- 打开 Chrome → 设置 → 隐私和安全 → 网站设置 → 附加内容设置 → 自动下载
- 关闭开关:✅ “当网站尝试在首次下载后自动下载文件时询问”
? 此设置位于用户配置文件层级,对所有 WebDriver 启动的实例生效(除非指定
--user-data-dir)。
? 其他注意事项
-
驱动与 Selenium 版本匹配:确保使用 ChromeDriver 117.x 及 Selenium 4.11+,旧版 Selenium 对
--remote-allow-origins支持不完善; -
目录权限与路径有效性:
download.default_directory必须是绝对路径,且目标文件夹需存在、可写(建议创建后赋权); -
PDF/Office 文件特殊处理:若下载 PDF 仍被 Chrome 内置查看器拦截,请确认
plugins.always_open_pdf_externally=true已生效,并避免触发Content-Disposition: inline响应头; -
无头模式兼容性:
--headless=new在 Chrome 117+ 中支持下载,但需额外添加--no-sandbox(Linux)或确保沙箱权限,且仍需完整配置上述 prefs。
✅ 验证是否生效
执行下载操作后,检查:
- 目标目录中是否直接出现文件(无弹窗);
- Chrome 地址栏右侧是否显示「正在下载」图标(而非「保存」图标);
- 控制台无
Download is disabled in incognito mode类警告。
通过以上组合配置,可彻底规避 Chrome 117+ 的自动下载拦截问题,恢复稳定、静默的 Selenium 文件下载流程。


















