Java Selenium如何处理‘另存为’弹窗并实现文件下载？

Selenium无法直接控制浏览器原生的“另存为”弹窗（这类属于系统级弹窗，不在WebDriver的DOM控制范围内），最稳定可靠的方案是通过配置浏览器参数，让文件直接下载到指定路径，完全跳过弹窗环节。

Chrome 浏览器配置实现 #

通过ChromeOptions设置下载偏好，指定默认路径并关闭弹窗提示：

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

public class ChromeDownloadHandler {
    public static void main(String[] args) {
        // 配置ChromeDriver路径（替换为你本地的实际路径）
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver.exe");
        
        // 自定义下载路径
        String targetDownloadPath = "D:/Selenium_Downloads";
        
        ChromeOptions options = new ChromeOptions();
        Map<String, Object> downloadPrefs = new HashMap<>();
        
        // 设置默认下载目录
        downloadPrefs.put("download.default_directory", targetDownloadPath);
        // 关闭下载前的弹窗提示
        downloadPrefs.put("download.prompt_for_download", false);
        // 强制PDF文件直接下载，不在浏览器中预览
        downloadPrefs.put("plugins.always_open_pdf_externally", true);
        
        options.setExperimentalOption("prefs", downloadPrefs);
        
        // 启动Chrome浏览器
        ChromeDriver driver = new ChromeDriver(options);
        
        // 访问目标页面，触发下载操作
        driver.get("https://your-download-url.com");
        // 点击下载按钮（示例，根据实际页面元素调整）
        // driver.findElement(By.cssSelector("button.download-btn")).click();
        
        // 可添加下载完成后的验证逻辑（如检查目标路径下是否存在文件）
        
        // 关闭浏览器
        // driver.quit();
    }
}

Firefox 浏览器配置实现 #

通过FirefoxProfile配置下载相关偏好：

import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.firefox.FirefoxOptions;
import org.openqa.selenium.firefox.FirefoxProfile;

public class FirefoxDownloadHandler {
    public static void main(String[] args) {
        // 配置GeckoDriver路径（替换为你本地的实际路径）
        System.setProperty("webdriver.gecko.driver", "path/to/geckodriver.exe");
        
        String targetDownloadPath = "D:/Selenium_Downloads";
        
        FirefoxProfile profile = new FirefoxProfile();
        // 设置下载目录
        profile.setPreference("browser.download.dir", targetDownloadPath);
        // 强制使用自定义目录而非默认下载文件夹
        profile.setPreference("browser.download.folderList", 2);
        // 关闭下载管理器启动时的弹窗
        profile.setPreference("browser.download.manager.showWhenStarting", false);
        // 指定无需弹窗提示直接下载的文件MIME类型（多个用逗号分隔）
        profile.setPreference("browser.helperApps.neverAsk.saveToDisk", 
                            "application/pdf,application/octet-stream,application/vnd.ms-excel");
        
        FirefoxOptions options = new FirefoxOptions();
        options.setProfile(profile);
        
        // 启动Firefox浏览器
        FirefoxDriver driver = new FirefoxDriver(options);
        
        // 访问页面并触发下载
        driver.get("https://your-download-url.com");
        // driver.findElement(By.id("download-button")).click();
        
        // 验证下载结果
        
        // driver.quit();
    }
}

注意事项 #

• 务必将代码中的驱动路径（chromedriver.exe/geckodriver.exe）替换为本地实际路径
• browser.helperApps.neverAsk.saveToDisk的MIME类型需匹配你要下载的文件类型，可通过浏览器开发者工具查看下载链接的Content-Type获取
• 不推荐使用AutoIt、Robot类等工具操作原生弹窗：这类方案依赖系统环境和浏览器版本，兼容性差，极易出现不稳定情况

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