在Mac上使用Selenium ChromeDriver 3.11.0实现文件自动下载

Hey there, let's work through this ChromeDriver config issue step by step. I’ve been in your shoes before—tweaking those preferences can feel like navigating a maze at first! Let’s break down the fixes and common pitfalls:

1. 补全并修正你的下载配置代码 #

你已经开了个好头，这里把完整且正确的配置补全，重点关注路径格式和关键参数：

System.setProperty("webdriver.chrome.driver", "/Users/username/chromedriver");
// macOS路径用正斜杠，避免双斜杠开头的错误写法
String downloadFilepath = "/Users/username/automation-testing/"; 
HashMap<String, Object> chromePrefs = new HashMap<>();

// 关闭下载弹窗提示
chromePrefs.put("profile.default_content_settings.popups", 0);
// 指定默认下载目录
chromePrefs.put("download.default_directory", downloadFilepath);
// 可选：设置PDF自动下载，不打开浏览器预览
chromePrefs.put("plugins.always_open_pdf_externally", true);

// 将配置注入ChromeOptions
ChromeOptions options = new ChromeOptions();
options.setExperimentalOption("prefs", chromePrefs);

// 处理macOS专属权限问题
// 若遇到"无法打开chromedriver"提示，先在终端执行：xattr -d com.apple.quarantine /Users/username/chromedriver
options.addArguments("--disable-features=ImprovedCookieControls");
options.addArguments("--disable-extensions");

// 初始化Driver
WebDriver driver = new ChromeDriver(options);

2. 避坑指南：常见权限与配置误区 #

• 路径格式错误：macOS/Linux用单正斜杠/，Windows用双反斜杠\\；也可以用new File(downloadFilepath).getAbsolutePath()生成跨平台的正确路径。
• ChromeDriver权限问题：
  • macOS：首次运行会被系统拦截，去「系统设置-隐私与安全性」手动允许，或用终端命令xattr -d com.apple.quarantine /Users/username/chromedriver解除隔离。
  • Linux：确保chromedriver有可执行权限，执行chmod +x /path/to/chromedriver。
• 版本不匹配：ChromeDriver版本必须和你的Chrome浏览器大版本完全一致（比如Chrome 120对应ChromeDriver 120.x.x），版本不兼容会导致配置失效或启动失败。
• 无头模式额外配置：如果用无头模式运行，需添加这些参数保证下载正常：

options.addArguments("--headless=new");
options.addArguments("--disable-gpu");
options.addArguments("--window-size=1920,1080");
options.addArguments("--disable-features=DownloadBubble");

3. 验证配置是否生效 #

• 让Driver访问一个可下载的测试链接，检查文件是否出现在指定目录。
• 在Driver打开的Chrome中输入chrome://settings/downloads，确认默认下载路径和你设置的一致。

如果还是有问题，试试关闭所有Chrome进程后重新运行脚本，或者用options.addArguments("--incognito")以无痕模式启动，避免旧缓存或用户配置干扰。

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