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:

MonkeyCode
MonkeyCode

企业级AI开发平台,全新的AI编程体验,让你的研发团队效率Max

下载

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工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

1017

2023.08.11

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

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

814

2023.11.06

Java Maven专题
Java Maven专题

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

0

2025.09.15

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

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

1377

2023.07.26

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

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

1159

2023.07.27

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

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

827

2023.08.01

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

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

460

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2361

2023.08.08

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

0

2026.03.03

热门下载

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

精品课程

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

共23课时 | 4.1万人学习

C# 教程
C# 教程

共94课时 | 10.6万人学习

Java 教程
Java 教程

共578课时 | 75.9万人学习

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

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