17370845950

chromedriver 启用 headless 模式失败，通常因参数版本不兼容导致；本文详解 `--headless=new` 与旧版 `--headless` 的适用场景、完整配置步骤及避坑要点。

在使用 Selenium + ChromeDriver 实现无头（headless）自动化时，若调用 options.add_argument("--headless=new") 后浏览器窗口仍弹出，说明该参数未被当前 Chrome/ChromeDriver 版本正确识别——这并非代码逻辑错误，而是版本兼容性问题。

✅ 正确配置 headless 模式的两种方式

方式一：兼容旧版 Chrome（v109 之前）

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options

service = Service(executable_path=r".\chromedriver.exe")  # 注意路径应为相对或绝对有效路径
options = Options()
options.add_argument("--headless")  # 无 new 后缀，适用于 Chrome < v109
options.add_argument("--no-sandbox")
options.add_argument("--disable-dev-shm-usage")

driver = webdriver.Chrome(service=service, options=options)
print(driver.title)  # 验证是否静默运行
driver.quit()

方式二：启用新版 headless（Chrome v109+ 推荐）

options = Options()
options.add_argument("--headless=new")  # 必须搭配 Chrome v109 及以上
options.add_argument("--no-sandbox")
options.add_argument("--disable-gpu")  # Windows 下建议添加
options.add_argument("--disable-features=NetworkService")  # 增强稳定性

? 如何确认 Chrome 版本？ 在终端执行：chrome --version 或 google-chrome --version（Linux/macOS）； ChromeDriver 版本需与 Chrome 主版本号严格一致（如 Chrome 125.x → 需 ChromeDriver 125.x）。

⚠️ 关键注意事项

• 路径问题：executable_path 已在 Selenium 4.10+ 中弃用，推荐使用 Service 对象并确保 chromedriver 可执行权限（Windows 注意 .exe 后缀，Linux/macOS 需 chmod +x）；
• 安全参数必加：--no-sandbox 和 --disable-dev-shm-usage 在 headless 环境中不可或缺，否则易触发崩溃或超时；
• 调试技巧：临时移除 --headless* 参数可快速验证环境是否正常；也可添加 options.add_argument("--remote-debugging-port=9222") 配合 Chrome DevTools 调试；
• Docker/CI 场景：务必安装字体库（如 fonts-liberation）和音视频依赖，避免渲染异常。

✅ 验证是否真正 headless

运行后检查进程：

• Linux/macOS：ps aux | grep chrome | grep -v grep —— 不应出现 --headless 以外的 GUI 相关参数；
• Windows：任务管理器中查看 chrome.exe 进程属性，确认无窗口句柄（GetForegroundWindow() 返回 0）。

掌握版本匹配与最小化必要参数，即可稳定启用 headless 模式，大幅提升 CI/CD 流水线与服务器端自动化效率。