Java Selenium 4.25.0：隐身模式无法禁用下载“另存为”弹窗

问题核心原因 #

Chrome 129对隐身模式的会话沙箱做了强化隔离，常规的prefs配置会被隐身会话的独立环境覆盖，导致下载弹窗无法禁用。

修正后可用配置 #

针对隐身模式的特性，调整配置逻辑并修正原代码的语法错误：

HashMap<String, Object> chromePrefs = new HashMap<>();
chromePrefs.put("download.default_directory", downloadDir);
chromePrefs.put("download.prompt_for_download", false);
chromePrefs.put("download.directory_upgrade", true);
// 隐身模式下需双重禁用安全浏览保护
chromePrefs.put("safebrowsing.enabled", false);
chromePrefs.put("safebrowsing.disable_download_protection", true);

ChromeOptions options = new ChromeOptions();
// 彻底禁用下载相关UI组件
options.addArguments("disable-features=DownloadBubble,DownloadBubbleV2,DownloadUI");
options.addArguments("--safebrowsing-disable-download-protection");
options.addArguments("--safebrowsing-disable-extension-blacklist");

// 关键：通过localState传递全局配置（隐身模式优先读取该层级）
HashMap<String, Object> localState = new HashMap<>();
localState.put("download.default_directory", downloadDir);
localState.put("download.prompt_for_download", false);
options.setExperimentalOption("localState", localState);

options.setExperimentalOption("prefs", chromePrefs);
options.addArguments("--start-maximized");
options.addArguments("--disable-popup-blocking");
options.addArguments("--incognito");
options.addArguments("--disable-search-engine-choice-screen");

官方文档参考方向 #

1. Chrome DevTools Protocol (CDP) 下载控制
   Selenium 4原生支持CDP命令，这是当前隐身模式下最可靠的下载控制方式，不受沙箱限制：

   driver.executeCdpCommand("Page.setDownloadBehavior", Map.of(
       "behavior", "allow",
       "downloadPath", downloadDir
   ));
   

   该接口在Chrome官方CDP文档中明确标注为自动化场景的推荐方案。

2. Chrome官方策略配置文档
   可通过Chrome内置的chrome://policy页面查看隐身模式下的内容策略规则，部分managed_default_content_settings参数需通过策略级配置生效，但自动化场景下CDP命令优先级更高。

3. Selenium官方文档
   Selenium 4的ChromeOptions章节明确说明，针对隐私模式（隐身）的特殊需求，需结合CDP命令补充配置，不能仅依赖prefs参数。

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