Java Selenium在Jenkins上用Chrome WebDriver kiosk-printing无法下载PDF

核心问题分析 #

本地Mac环境正常，但Windows Jenkins上无法通过--kiosk-printing自动下载PDF，排除权限问题后，主要原因集中在Windows路径格式错误、Chrome在Jenkins服务会话中的UI限制、Chrome偏好设置参数不兼容这几点。

具体修复方案 #

1. 修正Windows下载路径格式 #

代码中使用的类Unix路径/random/path/for/online/question不兼容Windows系统，需改用反斜杠（转义为\\）或正斜杠的绝对路径，同时补充目录升级参数确保Chrome使用指定路径：

// Windows绝对路径示例（二选一）
chromeOptions.addArguments("--download.default_directory=C:\\jenkins\\automation\\pdf_downloads");
chromeOptions.addArguments("--download.default_directory=C:/jenkins/automation/pdf_downloads");

// 补充偏好设置，强制使用指定下载目录
prefs.put("download.directory_upgrade", true);

2. 统一Chrome PDF相关偏好设置 #

代码中存在参数类型不一致的问题（plugins.always_open_pdf_externally同时设为字符串和布尔值），整理后的可靠配置如下：

HashMap<String, Object> prefs = new HashMap<>();
prefs.put("download.behavior", "allow");
prefs.put("profile.default_content_settings.popups", 0); // 用0代替false更兼容
prefs.put("download.prompt_for_download", false);
prefs.put("download.directory_upgrade", true);
prefs.put("plugins.always_open_pdf_externally", true);
prefs.put("browser.helperApps.neverAsk.saveToDisk", "application/pdf");
prefs.put("plugins.plugins_disabled", new String[]{"Chrome PDF Viewer"});

chromeOptions.setExperimentalOption("prefs", prefs);

3. 调整Jenkins运行上下文 #

若Jenkins以Windows服务形式运行，默认无桌面会话权限，会导致Chrome隐性系统弹窗无法处理：

• 打开Windows服务管理器，找到Jenkins服务，右键选「属性」
• 切换到「登录」标签页，勾选「允许服务与桌面交互」
• 重启Jenkins服务；或改用Jenkins Windows Slave节点，以有桌面权限的本地用户身份启动Slave进程

4. 改用Chrome DevTools Protocol (CDP) 直接打印PDF（推荐） #

完全绕过页面打印按钮和系统弹窗，通过CDP直接生成PDF，兼容性更强：

// 初始化ChromeDriver后获取CDP会话
ChromeDriver driver = new ChromeDriver(chromeOptions);
DevTools devTools = driver.getDevTools();
devTools.createSession();

// 配置PDF打印参数
Map<String, Object> printParams = new HashMap<>();
printParams.put("path", "C:\\jenkins\\automation\\pdf_downloads\\output.pdf"); // 自定义保存路径
printParams.put("landscape", false);
printParams.put("displayHeaderFooter", false);
printParams.put("printBackground", true);

// 执行打印命令
devTools.send(Page.printToPDF(printParams));

该方式无需依赖页面元素，直接通过协议生成PDF，不受Jenkins服务环境限制。

额外注意事项 #

• 不要用Robot类处理系统弹窗：Robot依赖桌面会话，Jenkins服务环境下无有效上下文，按键会失效。
• 确保Chrome与ChromeDriver版本匹配：版本不兼容可能导致下载行为异常。

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