讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

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

小墨君_7758

小墨君_7758

发布时间:2026-01-14 21:06:09

|

602人浏览过

|

来源于php中文网

原创

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

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

在 Selenium 自动化测试中,SessionNotCreatedException: This version of ChromeDriver only supports Chrome version X 是高频报错——即使你确认“已安装最新 Chrome”,仍可能因 ChromeDriver 版本滞后或错配而失败。根本原因在于:ChromeDriver 仅支持特定主版本号(Major Version)的 Chrome 浏览器,例如 ChromeDriver 96.x 仅支持 Chrome 96.x,无法兼容 Chrome 109。

✅ 正确排查与解决步骤

1. 精确获取 Chrome 当前主版本号

打开 Chrome 浏览器 → 右上角「⋮」→「设置」→「关于 Chrome」,查看完整版本号(如 109.0.5414.74)。只需取第一位数字(109)作为主版本号,这是匹配 ChromeDriver 的唯一依据。

2. 下载对应主版本的 ChromeDriver

访问官方下载页:https://www.php.cn/link/73715c097259c228af0648823d754407
→ 找到与 Chrome 主版本一致的最新驱动(如 Chrome 109 → 选择 ChromeDriver 109.x.x)→ 下载 chromedriver_win32.zip(Windows)并解压。

⚠️ 注意:不要使用第三方打包的 chromedriver.exe,务必从官网下载;旧版镜像站(如已失效的 sites.google.com/a/chromium.org/chromedriver)已迁移至新域名。

3. 正确配置 WebDriver(推荐方式)

避免硬编码路径和过时的系统属性设置:

// ❌ 过时写法(Selenium 3+ 已不推荐)
// System.setProperty("webdriver.chromer.driver", "C:\chromedriver.exe");

// ✅ 推荐写法(Selenium 4+ 自动管理 + 显式路径)
ChromeOptions options = new ChromeOptions();
options.addArguments("--no-sandbox");
options.addArguments("--disable-dev-shm-usage");

// 方式1:指定解压后的 chromedriver.exe 绝对路径(确保版本匹配)
WebDriver driver = new ChromeDriver(
    new ChromeDriverService.Builder()
        .usingDriverExecutable(new File("C:/tools/chromedriver-win32/chromedriver.exe"))
        .build(),
    options
);

// 方式2(更优):使用 WebDriverManager(自动下载匹配驱动,见下文)

4. 进阶方案:用 WebDriverManager 自动化管理(强烈推荐)

引入 WebDriverManager 库,它能自动检测 Chrome 版本并下载/缓存匹配的 ChromeDriver:

JavaScript 测试模式
JavaScript 测试模式

使用 Jest、Vitest 和 Testing Library 实施全面的测试策略,包括单元测试、集成测试和端到端测试,涵盖模拟、测试夹具和测试驱动开发。在编

下载

Maven 依赖:

<dependency>
    <groupId>io.github.bonigarcia</groupId>
    <artifactId>webdrivermanager</artifactId>
    <version>5.6.3</version> <!-- 支持 Chrome 109+ -->
</dependency>

Java 代码:

import static io.github.bonigarcia.wdm.WebDriverManager.chromedriver;

public class ChromeTest {
    public static void main(String[] args) {
        // 自动检测 Chrome 版本 → 下载对应 ChromeDriver → 设置系统属性
        chromedriver().setup(); 

        ChromeOptions options = new ChromeOptions();
        options.addArguments("--headless"); // 可选:无头模式
        WebDriver driver = new ChromeDriver(options);

        driver.get("https://www.google.com");
        System.out.println("Title: " + driver.getTitle());
        driver.quit();
    }
}

✅ 优势:无需手动下载、无需关注路径、支持 CI/CD 环境、自动处理版本升级。

? 关键注意事项

  • Chrome 浏览器更新后(如从 108 升级到 109),必须同步更新 ChromeDriver;
  • System.setProperty("webdriver.chromer.driver", ...) 中属性名拼写错误(应为 webdriver.chrome.driver,不是 chromer)会导致静默失败;
  • Selenium 4.6+ 已内置对 Chrome 110+ 的支持,但 ChromeDriver 仍需手动/自动匹配;
  • 若企业环境禁止外网访问,可预下载驱动并配置 wdm.cachePath 指向内网共享目录。

通过以上方法,即可彻底解决版本不兼容问题,让自动化脚本稳定运行。记住核心原则:Chrome 主版本号 = ChromeDriver 主版本号,其余皆为细节优化。

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

火山引擎

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

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

WorkBuddy

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

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

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

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

豆包大模型

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

相关专题

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

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

3006

2023.08.11

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

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

6299

2023.11.06

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

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

4507

2026.03.24

Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

4780

2025.09.15

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

409

2026.05.09

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

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

3499

2023.07.26

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

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

3038

2023.07.27

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

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

1548

2023.08.01

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

100

2026.11.12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

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

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