无头模式下ChromeDriver无法识别Chrome打印对话框求助

核心原因 #

旧版--headless模式下的Chrome是简化的无头运行环境，不会渲染原生系统对话框（比如打印弹窗），因此无法通过窗口句柄获取到它，这也是无头模式下只返回一个窗口句柄的原因。

解决方案 #

方案1：使用新版无头模式（推荐） #

Chrome 112及以上版本推出了新无头模式，行为更接近正常Chrome浏览器，支持原生对话框渲染。修改你的ChromeOptions配置，将旧的--headless替换为--headless=new：

public static void runChromeDriver() {
    String chromeDriverPath = "/home/nemanja/Downloads/chromedriver_linux64/chromedriver";

    System.setProperty("webdriver.chrome.driver", chromeDriverPath);

    ChromeOptions options = new ChromeOptions();
    // 替换为新版无头参数
    options.addArguments("--headless=new");
    options.addArguments("--window-size=1920, 1080");
    options.addArguments("--ignore-certificate-errors");

    HashMap<String, Object> prefs = new HashMap<String, Object>();

    prefs.put("profile.default_content_settings.popups", 0);
    prefs.put("download.default_directory", getFullPathToTempDirectory());
    prefs.put("download.prompt_for_download", false);
    prefs.put("download.directory_upgrade", true);
    prefs.put("plugins.always_open_pdf_externally", true);

    options.setExperimentalOption("prefs", prefs);

    chromeDriver = new ChromeDriver(options);
}

注意：如果你的ChromeDriver版本是111，建议同步升级Chrome浏览器和ChromeDriver到112+，以完全兼容新无头模式。

方案2：通过DevTools API直接生成PDF（更稳定） #

绕过打印对话框，直接调用Chrome的DevTools API生成PDF，无需交互原生控件，这是无头环境下处理打印需求的最优方案：

import org.openqa.selenium.devtools.DevTools;
import org.openqa.selenium.devtools.v111.page.Page;
import java.nio.file.Paths;

// 替换原有的clickOnSaveAsPdf方法
private static void saveAsPdfViaDevTools() {
    DevTools devTools = chromeDriver.getDevTools();
    devTools.createSession();
    
    // 配置PDF生成参数
    Page.PrintToPDFOptions pdfOptions = new Page.PrintToPDFOptions()
            .setPaperWidth(8.5)
            .setPaperHeight(11)
            .setPrintBackground(true) // 打印页面背景图/颜色
            .setPath(Paths.get(getFullPathToTempDirectory(), "output.pdf").toString());
    
    // 调用API生成PDF
    devTools.send(Page.printToPDF(pdfOptions));
}

这种方式无需依赖打印对话框，直接在后台生成PDF文件，彻底避免了原生控件交互的兼容性问题。

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