Chrome 无头模式默认不支持弹出式打印对话框，导致 getWindowHandles() 无法捕获新窗口句柄；本文提供兼容性配置与可靠等待策略，确保 PDF 导出流程在 headless 环境中稳定运行。
chrome 无头模式默认不支持弹出式打印对话框，导致 `getwindowhandles()` 无法捕获新窗口句柄；本文提供兼容性配置与可靠等待策略，确保 pdf 导出流程在 headless 环境中稳定运行。
在自动化测试或无头 PDF 生成场景中，开发者常期望通过 Selenium 触发页面上的「另存为 PDF」按钮（如 Chrome 原生打印对话框），再切换至该对话框进行操作。然而，Chrome 的 headless 模式（--headless）本质上不渲染 UI 组件，也不启动任何浏览器弹窗——包括打印对话框（Print Dialog）。这是设计使然，而非 Bug：无头浏览器无 GUI，自然无法展示、也无法暴露打印对话框的窗口句柄。
因此，你观察到的现象完全符合预期：
- 非无头模式下：getWindowHandles() 返回两个句柄（主页面 + 打印对话框窗口）；
- 无头模式下：仅返回一个句柄（仅有主页面），因为打印对话框根本未被创建。
⚠️ 关键结论：你无法在 --headless 模式下“切换”或“操作”打印对话框——它不存在。
✅ 正确解法：绕过打印对话框，直接触发后台 PDF 导出
Chrome 提供了无头友好的替代方案：通过 DevTools Protocol (CDP) 发送 Page.printToPDF 命令，无需 UI 交互即可生成 PDF。Selenium 4+ 原生支持 CDP，Java 示例代码如下：
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.devtools.DevTools;
import org.openqa.selenium.devtools.v111.page.Page;
import java.util.Base64;
import java.nio.file.Files;
import java.nio.file.Paths;
// ... 启动 ChromeDriver 后（仍可保留 --headless）
DevTools devTools = chromeDriver.getDevTools();
devTools.createSession();
// 触发 PDF 导出（等效于点击“保存为 PDF”，但无 UI）
byte[] pdfBytes = devTools.send(Page.printToPDF(
Page.PrintToPDFRequest.builder()
.landscape(false)
.printBackground(true)
.preferCSSPageSize(true)
.build()
));
// 保存为文件
Files.write(Paths.get("output.pdf"), pdfBytes);
System.out.println("PDF 已成功导出至 output.pdf");✅ 优势：无需等待窗口句柄、不依赖 DOM 按钮点击、兼容 headless、输出质量可控（支持页边距、背景、纸张尺寸等参数）。
⚠️ 若必须保留 --headless + 按钮点击逻辑？请勿尝试“等待窗口句柄”
虽然答案中提到使用 WebDriverWait.until(numberOfWindowsToBe(2))，该方案在 headless 下永远失败——因为第二个窗口永远不会出现。此等待仅对非 headless 模式有效，强行使用会导致超时异常，误导调试方向。
✅ 正确做法是：彻底放弃对打印对话框的操作幻想，改用 CDP 方案。
? 补充建议：优化 ChromeOptions（提升稳定性）
即使采用 CDP，也建议调整启动参数以避免干扰：
ChromeOptions options = new ChromeOptions();
options.addArguments("--headless=new"); // 推荐使用新版 headless（Chromium 109+）
options.addArguments("--no-sandbox");
options.addArguments("--disable-gpu");
options.addArguments("--disable-dev-shm-usage");
options.addArguments("--disable-extensions");
// 移除与打印对话框无关的 prefs（如 popups、pdf_externally），它们对 CDP 无效
HashMap<String, Object> prefs = new HashMap<>();
prefs.put("download.default_directory", getFullPathToTempDirectory());
options.setExperimentalOption("prefs", prefs);? 总结
| 场景 | 是否可行 | 推荐方案 |
|---|---|---|
| Headless + 操作打印对话框 | ❌ 不可行（对话框不创建） | 放弃此路径 |
| Headless + 生成 PDF | ✅ 完全可行 | 使用 DevTools.send(Page.printToPDF()) |
| GUI 模式 + 自动化打印对话框 | ✅ 可行（需人工干预或 AutoIt 等工具） | 非 headless 场景下可结合 numberOfWindowsToBe(2) + switchTo().window() |
选择 CDP 方案不仅解决当前问题，更符合无头自动化最佳实践：去 UI 化、高可靠性、强可控性。
