Chrome 117 更新后 Selenium 文件自动下载失效的完整解决方案

浅涛君_3733

浅涛君_3733

2026-11-19

562人浏览

原创

Chrome 117 更新后 Selenium 文件自动下载失效的完整解决方案

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);</string>

? 浏览器端辅助配置(推荐双保险)

即使代码配置正确,Chrome 的全局策略仍可能覆盖 WebDriver 设置。请手动验证并关闭以下选项:

Bird Chrome
Bird Chrome

使用 bird 搭配 Chrome cookies 读取、搜索并在 X/Twitter 上谨慎发布内容。

下载
  1. 打开 Chrome → 设置 → 隐私和安全 → 网站设置 → 附加内容设置 → 自动下载
  2. 关闭开关:✅ “当网站尝试在首次下载后自动下载文件时询问”

    ? 此设置位于用户配置文件层级,对所有 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 文件下载流程。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

chrome

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

2023.10.13

5370

8

java测试工具有哪些
java测试工具有哪些

java测试工具有JUnit、TestNG、Mockito、Selenium、Apache JMeter和Cucumber。php还给大家带来了java有关的教程,欢迎大家前来学习阅读,希望对大家能有所帮助。

2023.10.23

3761

10

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

180

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
第二十三期_前端开发
第二十三期_前端开发

共98课时 | 12.1万人学习

Node.js基础教程
Node.js基础教程

共8课时 | 1.5万人学习

nodejs开发基础教程
nodejs开发基础教程

共15课时 | 5万人学习