本文详解 Selenium 中 IllegalStateException: The path to the driver executable must be set 错误的成因与解决方案，涵盖 ChromeDriver 下载、路径配置、版本兼容性及现代替代方案（如 WebDriverManager）。
本文详解 selenium 中 `illegalstateexception: the path to the driver executable must be set` 错误的成因与解决方案，涵盖 chromedriver 下载、路径配置、版本兼容性及现代替代方案（如 webdrivermanager）。
在使用 Selenium + Java 启动 Chrome 浏览器时，若遇到如下典型异常：
Exception in thread "main" java.lang.IllegalStateException: The path to the driver executable must be set by the webdriver.chrome.driver system property; ...
这表明 Selenium 无法定位 ChromeDriver 可执行文件——并非代码逻辑错误，而是环境配置缺失。根本原因在于：自 Selenium 4.0 起（尤其是 4.6+），ChromeDriver 不再默认内置，必须显式指定其本地路径或启用自动管理机制。
✅ 正确配置方式（推荐两种方案）
方案一：手动指定 ChromeDriver 路径（适用于调试/离线环境）
在调用 new ChromeDriver() 之前，通过 System.setProperty() 设置系统属性：
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
public class Open_browser {
public static void main(String[] args) {
// ✅ 关键步骤：必须在实例化 ChromeDriver 前设置
System.setProperty("webdriver.chrome.driver", "/path/to/chromedriver");
WebDriver driver = new ChromeDriver(); // 现在可安全初始化
driver.get("https://www.example.com");
driver.quit();
}
}⚠️ 注意事项：
- 路径需为 绝对路径（如 Windows：C:\selenium\chromedriver.exe；macOS/Linux：/usr/local/bin/chromedriver）；
- 文件必须具有可执行权限（Linux/macOS 执行 chmod +x chromedriver）；
- .exe 后缀在 Windows 上不可省略，其他系统则无后缀。
方案二：使用 WebDriverManager（推荐生产/跨平台项目）
避免手动下载与路径维护，引入 WebDriverManager 自动处理驱动下载与缓存：
-
添加 Maven 依赖（以最新稳定版为例）：
<dependency> <groupId>io.github.bonigarcia</groupId> <artifactId>webdrivermanager</artifactId> <version>5.9.2</version> </dependency>
-
代码中自动配置（无需硬编码路径）：
import io.github.bonigarcia.wdm.WebDriverManager; import org.openqa.selenium.WebDriver; import org.openqa.selenium.chrome.ChromeDriver;
public class Open_browser { public static void main(String[] args) { // ✅ 自动检测 Chrome 版本并下载匹配的 ChromeDriver WebDriverManager.chromedriver().setup();
WebDriver driver = new ChromeDriver();
driver.get("https://www.example.com");
driver.quit();
}}
> ? WebDriverManager 优势：自动适配 Chrome 版本、支持多平台、缓存复用、兼容 CI/CD 环境。 ### ? 版本兼容性关键提醒 - ChromeDriver 必须与本地 Chrome 浏览器**主版本号一致**（如 Chrome 125.x → 需 ChromeDriver 125.x）； - 查看 Chrome 版本：地址栏输入 `chrome://version`； - 下载对应驱动：[ChromeDriver 官方仓库](https://chromedriver.storage.googleapis.com/)； - Selenium 4.6+ 已弃用 `ChromeDriverService` 的显式构建方式，直接使用 `WebDriverManager.setup()` 或 `ChromeDriver` 构造函数即可。 ### ✅ 总结 该错误本质是驱动注册缺失，而非代码缺陷。优先采用 **WebDriverManager** 实现零配置、高兼容的自动化管理；仅在受限环境（如无外网）下使用手动路径方案，并务必确保路径正确、权限充足、版本匹配。正确配置后，`ChromeDriver` 将无缝启动，为后续自动化测试奠定可靠基础。
