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

ChromeDriver 与 Chrome 浏览器版本不匹配的完整解决方案

风静小哥_1866

风静小哥_1866

发布时间:2026-01-14 22:07:01

|

898人浏览过

|

来源于php中文网

原创

ChromeDriver 与 Chrome 浏览器版本不匹配的完整解决方案

chromedriver 版本必须严格匹配本地 chrome 浏览器主版本号(如 chrome 109 → 需 chromedriver 109.x),否则会抛出 `sessionnotcreatedexception`;本文详解如何精准识别版本、下载匹配驱动、配置路径及自动化管理方法。

在 Selenium 自动化测试中,SessionNotCreatedException: This version of ChromeDriver only supports Chrome version XX 是高频报错——即使你看到 Chrome 界面显示“已是最新版”,也不代表当前 ChromeDriver 能兼容它。根本原因在于:ChromeDriver 并非与 Chrome 完全同步更新,且仅保证对 Chrome 主版本号(如 109.0.5414.74 中的 109)向下兼容,一旦主版本不一致(例如用 ChromeDriver 96 驱动 Chrome 109),必然失败。

✅ 正确排查与解决步骤

1. 精确获取 Chrome 主版本号

不要依赖任务管理器或文件属性,而是通过 Chrome 内置路径确认:

  • 打开 Chrome 浏览器 → 右上角「⋮」→ Settings → About Chrome
  • 查看顶部显示的完整版本号(例如 Version 109.0.5414.74 (Official Build) (64-bit))→ 提取主版本号 109
? 小技巧:命令行快速获取(Windows): reg query "HKEY_CURRENT_USER\Software\Google\Chrome\BLBeacon" /v version或 PowerShell: (Get-Item 'C:\Program Files\Google\Chrome\Application\chrome.exe').VersionInfo.ProductVersion.Split('.')[0]

2. 下载对应主版本的 ChromeDriver

访问官方唯一可信源:https://www.php.cn/link/bad65e96c2c6456a4f82970601d39714(注意:旧链接 chromedriver.googlecode.com 已停用)

GitHub Bounty Hunter
GitHub Bounty Hunter

通过过滤诈骗/刷单仓库、跟踪竞争情况以及监控支付记录,寻找合法的GitHub赏金。适用于需要发现...

下载
  • 在页面中查找 Latest Release for Chrome 109(或对应主版本)
  • 下载 chromedriver_win32.zip(Windows)、chromedriver_mac64.zip(macOS)或 chromedriver_linux64.zip(Linux)
  • 解压后得到 chromedriver.exe(Windows)或无后缀可执行文件(macOS/Linux)

3. 修正代码中的配置错误

你原代码存在两个关键问题:

  • ❌ 错误的系统属性名:webdriver.chromer.driver → 应为 webdriver.chrome.driver(chromer 是拼写错误)
  • ❌ 硬编码路径易出错且不可移植

✅ 推荐写法(Java + Selenium 3.x/4.x):

// 方式1:显式指定驱动路径(确保路径正确且有执行权限)
System.setProperty("webdriver.chrome.driver", "D:/tools/chromedriver-v109/chromedriver.exe");
WebDriver driver = new ChromeDriver();

// 方式2(更健壮):使用 WebDriverManager(推荐!自动管理版本)
// Maven 依赖:<dependency><groupId>io.github.bonigarcia</groupId><artifactId>webdrivermanager</artifactId><version>5.6.2</version></dependency>
WebDriverManager.chromedriver().setup(); // 自动检测Chrome版本并下载匹配驱动
WebDriver driver = new ChromeDriver();

4. 高级建议:避免手动维护驱动

  • ✅ 启用 WebDriverManager(Selenium 4+ 原生支持 Selenium Manager,但 WebDriverManager 更成熟稳定):它能自动读取本地 Chrome 版本、下载、缓存、设置系统属性,彻底告别版本冲突。
  • ✅ 统一环境管理:在 CI/CD(如 Jenkins/GitHub Actions)中,通过脚本自动安装指定版本 Chrome + 对应 ChromeDriver,保障环境一致性。
  • ⚠️ 注意事项:
    • Chrome 安装路径可能为 C:\Program Files\Google\Chrome\Application\(64位)或 C:\Program Files (x86)\Google\Chrome\Application\(32位),需确认实际路径;
    • 若使用企业版 Chrome(如 Chrome Enterprise),需检查是否启用了策略限制驱动加载;
    • Selenium 4.6+ 已内置 Selenium Manager,可尝试 System.setProperty("webdriver.http.factory", "jdk-http-client"); 启用自动驱动管理(无需手动 setup)。

总结:版本不匹配不是“玄学异常”,而是可精准定位、自动化解决的标准流程。牢记三原则——查准主版本、下对驱动包、配正系统属性,再辅以 WebDriverManager 或 Selenium Manager,即可一劳永逸。

热门AI工具

更多
Loomy
Loomy Hot

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

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

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

PixPix
PixPix Hot

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

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

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

DeepSeek

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

相关专题

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

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

2746

2023.08.11

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

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

5419

2023.11.06

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

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

3867

2026.03.24

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

8565

2026.01.21

GitHub官网入口版本汇总
GitHub官网入口版本汇总

本专题整合了GitHub入口版本地址汇总,阅读专题下面的文章了解更多详细内容。

898

2026.04.02

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3259

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2838

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

1488

2023.08.01

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

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