Selenium-Java Chrome无痕/常规模式文件下载失败问题求助

核心问题分析 #

• 无痕模式下文件仅保存为.tmp：Chrome无痕模式会独立隔离配置，默认下载目录权限与常规模式不同，且可能未等文件完成下载就终止会话
• 常规模式C盘指定路径无法下载：C盘多数目录需管理员权限，或路径存在拼写/格式错误（你期望的C:\downloafFiles疑似笔误，应为C:\downloadFiles）

针对性修复方案 #

1. 修正下载路径配置 #

先确保目标路径存在且具备写入权限，直接指定正确的C盘路径：

// 指定目标下载路径
String loc = "C:\\downloadFiles";
// 自动创建目录，避免因路径不存在导致下载失败
File downloadDir = new File(loc);
if (!downloadDir.exists()) {
    downloadDir.mkdirs();
}

2. 调整Chrome偏好设置，适配无痕模式 #

修改chromePrefs配置，移除冲突项并添加无痕模式兼容设置：

Map<String, Object> chromePrefs = new HashMap<>();

// 基础下载配置
chromePrefs.put("download.prompt_for_download", false);
chromePrefs.put("download.default_directory", loc);
chromePrefs.put("download.directory_upgrade", true);
chromePrefs.put("profile.default_content_settings.popups", 0);
chromePrefs.put("profile.default_content_setting_values.automatic_downloads", 1);

// 移除冲突项：该配置会让文件尝试打开而非直接保存
// chromePrefs.put("download.extensions_to_open", "csv,xlsx,pdf,xls");

// 修正MIME类型，覆盖更多Excel格式
chromePrefs.put("browser.helperApps.neverAsk.saveToDisk", 
    "application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,text/csv,application/pdf");

// 无痕模式额外配置：禁用安全浏览严格检查，允许自定义下载目录
chromePrefs.put("safebrowsing.enabled", false);
chromePrefs.put("safebrowsing.disable_download_protection", true);
chromePrefs.put("incognito.managed_default_content_settings.downloads", 1);

3. 无痕模式启动参数优化 #

添加权限相关参数，避免下载被拦截：

if ("true".equalsIgnoreCase(incognitoMode)) {
    chromeOptions.addArguments("--incognito");
    chromeOptions.addArguments("--disable-popup-blocking");
    // 添加允许文件下载的权限参数
    chromeOptions.addArguments("--allow-file-access-from-files");
    chromeOptions.addArguments("--allow-downloads");
}

4. 常规模式权限处理 #

若C盘路径仍无法下载，以管理员身份运行测试程序，或选择C盘下有写入权限的子目录（如C:\Users\[你的用户名]\Downloads），避免使用受保护的系统文件夹。

5. 等待文件下载完成（解决tmp文件问题） #

触发下载操作后，添加等待逻辑，确保文件从.tmp转为最终格式：

public static void waitForDownloadCompletion(String downloadDir, String fileNamePattern) throws InterruptedException {
    File dir = new File(downloadDir);
    long startTime = System.currentTimeMillis();
    boolean downloaded = false;

    // 最多等待30秒超时
    while (System.currentTimeMillis() - startTime < 30000) { 
        for (File file : dir.listFiles()) {
            if (file.getName().matches(fileNamePattern) && !file.getName().endsWith(".tmp")) {
                downloaded = true;
                break;
            }
        }
        if (downloaded) break;
        Thread.sleep(1000);
    }
}

使用示例：触发下载后调用waitForDownloadCompletion("C:\\downloadFiles", ".*\\.(xlsx|csv|pdf)")

完整修改后的ChromeOptions配置 #

private static ChromeOptions setChromeOptions(String headless, String browserDimensions, String incognitoMode) {
    ChromeOptions chromeOptions = new ChromeOptions();
    chromeOptions.addArguments("--enable-notifications");

    // 指定目标下载路径
    String loc = "C:\\downloadFiles";
    File downloadDir = new File(loc);
    if (!downloadDir.exists()) {
        downloadDir.mkdirs();
    }

    Map<String, Object> chromePrefs = new HashMap<>();

    // 基础下载配置
    chromePrefs.put("download.prompt_for_download", false);
    chromePrefs.put("plugins.always_open_pdf_externally", true);
    chromePrefs.put("download.default_directory", loc);
    chromePrefs.put("download.directory_upgrade", true);
    chromePrefs.put("safebrowsing.enabled", false);
    chromePrefs.put("safebrowsing.disable_download_protection", true);
    // 修正MIME类型，覆盖更多格式
    chromePrefs.put("browser.helperApps.neverAsk.saveToDisk", 
        "application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,text/csv,application/pdf");
    chromePrefs.put("profile.default_content_setting_values.automatic_downloads", 1);
    chromePrefs.put("profile.default_content_settings.popups", 0);
    // 无痕模式兼容配置
    chromePrefs.put("incognito.managed_default_content_settings.downloads", 1);

    chromeOptions.setExperimentalOption("prefs", chromePrefs);

    if ("true".equalsIgnoreCase(headless)) {
        chromeOptions.addArguments("--headless=new"); // 使用新版无头模式，兼容性更好
        chromeOptions.addArguments("--disable-gpu");
    }
    if (browserDimensions != null && !browserDimensions.isEmpty()) {
        browserDimensions = browserDimensions.replace("x", ",");
        chromeOptions.addArguments("--window-size=" + browserDimensions);
    }
    if ("true".equalsIgnoreCase(incognitoMode)) {
        chromeOptions.addArguments("--incognito");
        chromeOptions.addArguments("--disable-popup-blocking");
        chromeOptions.addArguments("--allow-file-access-from-files");
        chromeOptions.addArguments("--allow-downloads");
    }

    chromeOptions.addArguments("--no-sandbox");
    chromeOptions.addArguments("--disable-infobars");
    chromeOptions.addArguments("--disable-dev-shm-usage");
    chromeOptions.addArguments("--disable-browser-side-navigation");
    chromeOptions.addArguments("--ignore-certificate-errors");

    chromeOptions.setAcceptInsecureCerts(true);

    return chromeOptions;
}

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