我来帮你搞定这个无头模式下的文件下载问题！你遇到的情况很常见，主要是老版本ChromeDriver对无头下载的参数支持和非无头模式有差异，加上你的配置里有些关键参数没设置到位。

问题分析 #

你当前使用的ChromeDriver 2.34对应Chrome 61-63版本，虽然Chrome 60+已经支持无头下载，但老版本的ChromeDriver对browser.set_download_behavior这个参数的支持并不完善，而且你缺少几个确保无头模式下自动下载的关键配置。

正确实现示例 #

以下是适配你当前版本的完整代码，我会标注每个参数的作用：

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;
import java.util.HashMap;

public class HeadlessDownloadExample {
    public static void main(String[] args) {
        // 替换为你的绝对下载路径，无头模式下必须用绝对路径！
        String downloadDir = "/path/to/your/download/directory";

        // 配置Chrome偏好设置
        HashMap<String, Object> chromePrefs = new HashMap<>();
        // 禁用弹出窗口
        chromePrefs.put("profile.default_content_settings.popups", 0);
        // 设置默认下载目录（绝对路径）
        chromePrefs.put("download.default_directory", downloadDir);
        // 禁用下载前的提示弹窗
        chromePrefs.put("download.prompt_for_download", false);
        // 允许自动升级下载目录（避免权限问题）
        chromePrefs.put("download.directory_upgrade", true);
        // 指定自定义下载目录模式（2表示自定义路径）
        chromePrefs.put("browser.download.folderList", 2);
        // 设置允许自动保存的文件MIME类型，根据你要下载的文件类型调整
        chromePrefs.put("browser.helperApps.neverAsk.saveToDisk", 
                        "application/pdf,application/octet-stream,text/csv");

        // 配置ChromeOptions
        ChromeOptions options = new ChromeOptions();
        options.setExperimentalOption("prefs", chromePrefs);
        options.addArguments("--headless");
        options.addArguments("--disable-gpu");
        // 禁用弹窗拦截，确保下载请求能正常触发
        options.addArguments("--disable-popup-blocking");
        // 解决Linux环境下的沙箱问题（Windows环境可忽略，但保留也无影响）
        options.addArguments("--no-sandbox");
        // 避免/dev/shm内存不足的问题
        options.addArguments("--disable-dev-shm-usage");

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

        // 这里添加你的业务逻辑，比如导航到下载页面触发下载
        // driver.get("your-download-page-url");
        // ...

        // 记得关闭driver
        // driver.quit();
    }
}

关键注意事项 #

• 绝对路径要求：无头模式下download.default_directory必须设置为绝对路径，相对路径会导致下载失败或文件找不到。
• MIME类型配置：browser.helperApps.neverAsk.saveToDisk需要包含你要下载文件的MIME类型，Chrome会根据这个判断是否自动保存，无需弹窗询问。你可以通过浏览器开发者工具查看目标文件的MIME类型。
• 版本兼容性：如果条件允许，建议升级ChromeDriver到对应Chrome版本的最新稳定版（比如Chrome 63对应ChromeDriver 2.36），新版本对无头模式的支持更完善，能减少很多兼容性问题。
• 环境适配参数：--no-sandbox和--disable-dev-shm-usage主要适配Linux环境，Windows环境可去掉，但保留也不会有负面影响。

这样调整后，你的无头模式应该就能正常触发文件下载了！

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