0

0

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

碧海醫心

碧海醫心

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

|

382人浏览过

|

来源于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:

Maven 依赖:

谱乐AI
谱乐AI

谱乐AI,集成 Suno、Udio 等顶尖AI音乐模型的一站式AI音乐生成平台。

下载

    io.github.bonigarcia
    webdrivermanager
    5.6.3 

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 主版本号,其余皆为细节优化。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

832

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

737

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

734

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16925

2023.08.03

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.5万人学习

C# 教程
C# 教程

共94课时 | 6.7万人学习

Java 教程
Java 教程

共578课时 | 45.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号