讲师中心 微信公众号
AI工具推荐 视频效率加速

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

小芳大大_3229

小芳大大_3229

发布时间:2026-01-11 15:28:12

|

830人浏览过

|

来源于php中文网

原创

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

? 版本自查建议

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

linux-performance-analyzer
linux-performance-analyzer

Linux 性能分析与调优专家,覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景:系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

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

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

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

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

2526

2023.08.11

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

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

4519

2023.11.06

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

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

3287

2026.03.24

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

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

3710

2023.06.21

如何安装LINUX
如何安装LINUX

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

3213

2023.06.29

linux find
linux find

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

2293

2023.06.30

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

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

5510

2023.07.05

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

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

5182

2023.07.06

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

200

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn