ChromeDriver 版本不兼容问题的完整解决方案-java教程-PHP中文网

ChromeDriver 版本不兼容问题的完整解决方案

本文详细讲解如何解决 ChromeDriver 与 Chrome 浏览器版本不匹配导致的 SessionNotCreatedException 异常，重点介绍升级 WebDriverManager、切换至新版 Chrome for Testing 下载源及手动配置方法。

本文详细讲解如何解决 chromedriver 与 chrome 浏览器版本不匹配导致的 `sessionnotcreatedexception` 异常，重点介绍升级 webdrivermanager、切换至新版 chrome for testing 下载源及手动配置方法。

当运行 Selenium 测试时出现类似以下错误：

org.openqa.selenium.SessionNotCreatedException: 
Could not start a new session. Response code 500. 
Message: session not created: This version of ChromeDriver only supports Chrome version 114
Current browser version is 116.0.5845.96

这表明你本地安装的 Chrome 已升级至 v116，但所用 ChromeDriver 仍为仅支持 v114 的旧版——根本原因在于：自 Chrome 115 起，官方正式弃用传统的 chromedriver.storage.googleapis.com 分发渠道，转而采用 Chrome for Testing 新平台，该平台按浏览器主版本（如 116）提供配套的稳定驱动、Stable/Beta/Dev/Canary 构建及对应校验文件。

✅ 推荐解决方案（首选自动化）：
升级 WebDriverManager 至 v5.5.3 或更高版本（当前最新为 v5.6.2），它已原生适配新下载源：

<!-- Maven 依赖 -->
<dependency><groupid>io.github.bonigarcia</groupid><artifactid>webdrivermanager</artifactid><version>5.6.2</version><!-- 建议使用最新版 --></dependency>

并在测试初始化中启用自动管理（无需指定版本）：

mcp-chrome

使用MCP协议通过AI控制Chrome浏览器，适用于自动化浏览器任务，包括截取屏幕截图、填写表单、点击元素、浏览页面等操作。

下载

import io.github.bonigarcia.wdm.WebDriverManager;
import org.openqa.selenium.chrome.ChromeDriver;

public class ChromeTest {
    public static void main(String[] args) {
        // 自动检测 Chrome 版本并下载匹配的 driver
        WebDriverManager.chromedriver().setup();
        ChromeDriver driver = new ChromeDriver();
        driver.get("https://example.com");
        driver.quit();
    }
}

⚠️ 注意事项：

确保 chrome 命令或 Google Chrome.app 在系统 PATH 中可用（macOS 默认路径 /Applications/Google Chrome.app/Contents/MacOS/Google Chrome 已被正确识别）；
若项目禁用网络自动下载，可配合 forceDownload() + cachePath() 手动预置驱动；
避免硬编码 System.setProperty("webdriver.chrome.driver", "...") —— 这会绕过 WebDriverManager 的智能版本匹配逻辑。

? 备选方案（手动配置）：
若需离线部署或调试，可前往 Chrome for Testing 官网，根据 Chrome 主版本（如 116.0.5845.96 → 主版本为 116）查找对应 chromedriver 下载链接（例如：https://edgedl.me.gvt1.com/edgedl/chrome/chrome-for-testing/116.0.5845.96/mac-x64/chromedriver-mac-x64.zip），解压后通过 System.setProperty 指向本地路径。

? 总结：
Chrome v115+ 的驱动分发机制已重构，依赖旧版 WebDriverManager（升级 WebDriverManager 是最安全、可持续的解法；同时建议在 CI/CD 流程中添加 Chrome 与驱动版本校验步骤，避免环境漂移引发的偶发失败。