Selenium Headless 模式失效的常见原因与解决方案

小芳大大_3229

小芳大大_3229

2026-01-11

870人浏览

原创

Selenium Headless 模式失效的常见原因与解决方案

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"),可快速验证环境配置是否正确。

? 版本自查建议

运行以下命令确认本地环境:

CMIC Skill Scanner (BCLinux 21 / 低版本 glibc Linux x64)
CMIC Skill Scanner (BCLinux 21 / 低版本 glibc Linux x64)

使用内置 Rust 引擎审计待安装的 skill 包或归档,可选桥接外部扫描器。

下载
chrome --version          # 查看 Chrome 版本
chromedriver --version    # 查看 ChromeDriver 版本(需匹配)

二者主版本号(如 124.x)必须一致,否则 headless 行为不可靠。

总之,--headless=new 并非万能钥匙——它是 Chrome 116+ 的强制要求,而非降级兼容方案。精准匹配版本 + 规范初始化 + 必要安全参数,才是稳定运行 headless 模式的三大支柱。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3006

5

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.06

6279

7

Chrome开启无痕模式
Chrome开启无痕模式

本专题整合了Chrome无痕模式开启相关内容,阅读专题下面的文章了解更多详细教程。

2026.03.24

4507

22

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

4590

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3833

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

3173

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

7870

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

7482

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

4233

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习