
chromedriver 启用 headless 模式失败,通常因参数版本不兼容所致:新版 chrome(116+)需使用 --headless=new,而旧版驱动或 chrome 可能仅支持 --headless;同时需注意代码中未正确定义 webdriver 模块引用。
在 Selenium 中启用 Chrome 的无头(headless)模式是自动化测试和爬虫场景的常用实践,但实际运行中常出现“窗口仍弹出”问题。根本原因往往不在逻辑错误,而在于 Chrome 版本、ChromeDriver 版本与 headless 参数的兼容性不匹配。
✅ 正确写法(适配不同 Chrome 版本)
- Chrome ≥ 116(推荐):必须使用 --headless=new(新架构,更稳定,支持完整 DevTools 功能)
- Chrome ≤ 115:应使用 --headless(旧模式,--headless=new 将被忽略或报错)
同时,请确保导入语句完整——你原代码中使用了 webdriver.Chrome,但未导入 webdriver 模块:
from selenium import webdriver # ← 缺失此行会导致 NameError!
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
# ... 其他导入保持不变
service = Service(executable_path=r".\chromedriver.exe") # 注意路径建议用 .\ 而非 \(避免转义问题)
options = Options() # 推荐用 Options() 而非 webdriver.ChromeOptions()(后者虽可用,但非标准写法)
options.add_argument("--headless=new") # 或 "--headless"(根据 Chrome 版本选择)
options.add_argument("--no-sandbox")
options.add_argument("--disable-dev-shm-usage") # 提升容器/CI 环境稳定性
driver = webdriver.Chrome(service=service, options=options)
print("Headless mode active:", "headless" in driver.execute_script("return navigator.userAgent"))
driver.quit()⚠️ 关键注意事项
- 路径问题:executable_path=r"\chromedriver.exe" 中的 \c 是非法转义符,应改为 r".\chromedriver.exe" 或 "./chromedriver.exe"(推荐使用 Service() + ChromeDriverManager 自动管理驱动版本);
- 静默启动保障:除 --headless* 外,务必添加 --no-sandbox 和 --disable-dev-shm-usage,尤其在 Linux 容器或 CI 环境中,否则可能因权限或共享内存限制导致崩溃;
- 验证是否真正 headless:可通过 driver.execute_script("return navigator.webdriver") 返回 True,或检查 driver.title 是否可正常获取来间接确认;
- 调试技巧:临时移除 headless 参数并添加 options.add_argument("--start-maximized"),可快速验证环境配置是否正确。
? 版本自查建议
运行以下命令确认本地环境:
chrome --version # 查看 Chrome 版本 chromedriver --version # 查看 ChromeDriver 版本(需匹配)
二者主版本号(如 124.x)必须一致,否则 headless 行为不可靠。
总之,--headless=new 并非万能钥匙——它是 Chrome 116+ 的强制要求,而非降级兼容方案。精准匹配版本 + 规范初始化 + 必要安全参数,才是稳定运行 headless 模式的三大支柱。










