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

如何解决 Chrome 114+ 版本中 Headless 模式启动失败的问题

陌雪小哥_6677

陌雪小哥_6677

发布时间:2026-08-09 10:13:20

|

318人浏览过

|

来源于php中文网

原创

如何解决 Chrome 114+ 版本中 Headless 模式启动失败的问题

Chrome 114 及更高版本废弃了旧版 --headless 参数,必须改用 --headless=new 才能正常启动无头浏览器,否则会因 DevTools 连接失败导致 Session 创建异常。

chrome 114 及更高版本废弃了旧版 `--headless` 参数,必须改用 `--headless=new` 才能正常启动无头浏览器,否则会因 devtools 连接失败导致 session 创建异常。

在 Chrome 114+(对应 ChromeDriver 114.0.5735.90 及以上)中,Google 彻底重构了 Headless 模式实现机制。旧写法 --headless 或 chromeOptions.setHeadless(true) 已被弃用,若继续使用将触发如下典型错误:

[WARNING]: Browser-wide DevTools client failed to connect: disconnected: unable to connect to renderer
SessionNotCreatedException: disconnected: not connected to DevTools

这是因为新版 Headless 模式默认不启用完整的 DevTools 协议支持,而 Selenium 4.4+ 的 WebDriver 实现依赖该协议进行会话管理。唯一兼容且官方推荐的解决方案是显式指定 --headless=new。

✅ 正确配置示例(Java + Selenium 4.4+):

ChromeOptions options = new ChromeOptions();
options.addArguments("--start-maximized");
options.addArguments("--headless=new"); // ✅ 关键:必须使用 new 模式
options.addArguments("--no-sandbox");
options.addArguments("--disable-dev-shm-usage");
options.addArguments("--remote-allow-origins=*");

// 如需保留原有偏好设置(如下载路径、媒体权限等),仍可添加
Map<String, Object> chromePrefs = new HashMap<>();
chromePrefs.put("profile.default_content_settings.popups", 0);
options.setExperimentalOption("prefs", chromePrefs);

WebDriver driver = new ChromeDriver(options);

⚠️ 注意事项:

  • 不要混用 --headless 和 --headless=new,后者已完全取代前者;
  • chromeOptions.setHeadless(true) 在新版 ChromeDriver 中无效且可能引发冲突,应彻底移除;
  • --disable-gpu 和 --window-size 在 --headless=new 下非必需(新版本自动适配),但保留无害;
  • Windows 环境下务必保留 --no-sandbox 和 --disable-dev-shm-usage 以避免权限/内存问题;
  • 若测试涉及 WebRTC、摄像头或麦克风模拟,需额外添加 --use-fake-ui-for-media-stream 和 --use-fake-device-for-media-stream。

? 总结:从 Chrome 114 开始,“Headless” 不再是一个布尔开关,而是一个具有两种模式的特性——--headless=old(已移除)和 --headless=new(当前唯一有效模式)。升级后务必同步更新启动参数,这是保障自动化测试在 CI/CD 环境中稳定运行的关键一步。

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

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

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

豆包大模型

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

DeepSeek

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

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

LibLibAI
LibLibAI Hot

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

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

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

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

2666

2023.08.11

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

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

5119

2023.11.06

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

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

3647

2026.03.24

Sass和less的区别
Sass和less的区别

Sass和less的区别有语法差异、变量和混合器的定义方式、导入方式、运算符的支持、扩展性等。本专题为大家提供Sass和less相关的文章、下载、课程内容,供大家免费下载体验。

2627

2023.10.12

剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

0

2026.10.14

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

0

2026.10.14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

0

2026.10.14

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

0

2026.10.14

二狗PPT大纲编辑实操指南
二狗PPT大纲编辑实操指南

本专题聚焦二狗PPT结构化大纲的生成和修改,讲解标题、正文、目录、页数与页面顺序的调整方法,提升汇报逻辑和内容完整性。

0

2026.10.14

热门下载

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

精品课程

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

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