本文详解如何在 selenium 中绕过 chrome 打印对话框，实现静默保存为 pdf，关键在于启用移动设备模拟并精确配置打印参数，彻底规避“save as”弹窗。
本文详解如何在 selenium 中绕过 chrome 打印对话框，实现静默保存为 pdf，关键在于启用移动设备模拟并精确配置打印参数，彻底规避“save as”弹窗。
在使用 Selenium 自动化 Chrome 进行网页打印（尤其是导出为 PDF）时，开发者常遇到一个顽固问题：调用 window.print() 后，Chrome 仍会弹出“Save As”文件选择对话框，即使已通过 prefs 设置了 download.default_directory 和 savefile.default_directory，也无法生效。这是因为 Chrome 的原生打印预览（Print Preview）机制与下载流程分离——它不走常规下载管道，而是由打印后端直接触发系统级保存对话框，因此传统下载偏好设置对其完全无效。
根本解法：启用移动设备模拟（Mobile Emulation）
令人意外但经实测可靠的方案是：强制 Chrome 以移动端模式运行。原因在于，Chrome 在移动设备模拟下会跳过图形化打印预览界面，转而直接调用后台 PDF 渲染引擎，并将输出视为“可自动保存的资源”，从而响应 printing.print_preview_sticky_settings 中的配置，实现真正静默导出。
以下是完整、稳定、适配 Chrome v120+ 的 Python + Selenium 实现：
import json from selenium import webdriver from selenium.webdriver.chrome.options import Options def print_to_pdf_silently(url: str, output_dir: str = "F:/Downloads", filename: str = "output.pdf") -> None: options = Options() # ✅ 关键：启用移动设备模拟（绕过桌面版打印弹窗） mobile_emulation = { "deviceMetrics": {"width": 1024, "height": 600, "pixelRatio": 1.41}, "userAgent": "Mozilla/5.0 (Linux; Android 12; SM-G981B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.6167.184 Mobile Safari/537.36", "clientHints": {"platform": "Android", "mobile": True} } options.add_experimental_option("mobileEmulation", mobile_emulation) # ✅ 打印配置：指定“Save as PDF”为目标，禁用页眉页脚，设置 A4 尺寸与缩放 print_settings = { "recentDestinations": [{ "id": "Save as PDF", "origin": "local", "account": "" }], "selectedDestinationId": "Save as PDF", "version": 2, "isHeaderFooterEnabled": False, "mediaSize": { "height_microns": 297000, # A4 高度：297 mm → 297000 μm "width_microns": 210000, # A4 宽度：210 mm → 210000 μm "name": "ISO_A4", "custom_display_name": "A4" }, "customMargins": {}, "marginsType": 2, # “无边距”模式（0=默认, 1=最小, 2=无） "scaling": 100, # 缩放比例（100 = 1:1） "scalingType": 3, # 自定义缩放 "scalingTypePdf": 3, "isCssBackgroundEnabled": True # 保留 CSS 背景色（重要！） } # ✅ 其他必要选项（精简优化，移除无效参数） options.add_argument("--start-maximized") options.add_argument("--disable-gpu") options.add_argument("--no-sandbox") options.add_argument("--disable-dev-shm-usage") # ⚠️ 注意：--kiosk、--kiosk-printing、--enable-print-browser 等参数在新版 Chrome 中已弃用或无效，应移除 # ✅ 下载相关偏好（虽对打印非必需，但为兼容性保留） prefs = { "printing.print_preview_sticky_settings.appState": json.dumps(print_settings), "download.default_directory": output_dir, "download.prompt_for_download": False, "download.directory_upgrade": True, "profile.default_content_setting_values.automatic_downloads": 1, "safebrowsing.enabled": False # 可选：禁用安全浏览以减少干扰 } options.add_experimental_option("prefs", prefs) # 启动驱动（推荐使用 WebDriver Manager 自动管理 chromedriver 版本） driver = webdriver.Chrome(options=options) try: driver.get(url) # ✅ 触发打印（在移动模拟下将直接生成 PDF 并保存至 download.default_directory） driver.execute_script("window.print();") # ⏳ 等待 PDF 生成（建议配合文件存在轮询，此处为简化示例） import time time.sleep(3) # 实际项目中请用 os.path.exists + timeout 循环判断 print(f"✅ PDF 已静默保存至：{output_dir}/{filename}") finally: driver.quit() # 使用示例 if __name__ == "__main__": print_to_pdf_silently( url="https://www.google.com/", output_dir="F:/Downloads", filename="google_homepage.pdf" )关键注意事项与最佳实践：
- Chrome 版本兼容性：本方案在 Chrome 115–125 系列均验证有效；低于 115 版本可能需微调 scalingType 或 marginsType。
- 文件名控制限制：Chrome 原生打印 API 不支持动态指定 PDF 文件名（filename 参数无效），实际保存名固定为 “document.pdf” 或 “print.pdf”。如需自定义名称，需在保存后重命名（例如监听目录变化或使用 watchdog 库捕获新文件）。
- 页面加载保障：务必确保 driver.get() 后页面完全加载（可加 WebDriverWait(driver, 10).until(…)），否则 window.print() 可能截取空白页。
- 背景与字体渲染：务必启用 “isCssBackgroundEnabled”: True，否则按钮、卡片等带背景色的元素将变为白色；若含 Web 字体，建议添加 @font-face 预加载或使用 font-display: swap 避免渲染缺失。
- 替代方案提示：如需更高精度控制（如分页、水印、页码），建议转向 playwright-python（原生支持 page.pdf()）或服务端渲染（Puppeteer + Node.js / WeasyPrint）。
该方案摒弃了繁琐的 AutoIt 或 GUI 自动化工具，纯粹依托 Chrome 内建能力与 Selenium 标准接口，兼具稳定性、可维护性与跨平台特性，是当前自动化 PDF 打印场景中最优实践之一。