You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

线程"main"抛出IllegalStateException:需配置webdriver.chrome.driver系统属性

解决Selenium ChromeDriver的IllegalStateException:未设置驱动路径问题

你遇到的这个异常是Selenium最常见的问题之一——它找不到ChromeDriver的可执行文件位置,必须通过webdriver.chrome.driver这个系统属性来明确指定路径才行。下面给你几种靠谱的解决办法:

第一步:下载对应版本的ChromeDriver

首先得确保你下载的ChromeDriver版本和本地安装的Chrome浏览器版本完全匹配,版本不兼容也会出各种奇怪的问题。

第二步:指定ChromeDriver路径(三种方式选一种就行)

1. 在代码里直接设置

在你初始化ChromeDriver的代码之前,先添加一行设置系统属性的代码,把路径换成你自己的ChromeDriver文件位置:

// Windows系统示例(注意双反斜杠转义)
System.setProperty("webdriver.chrome.driver", "C:\\tools\\chromedriver.exe");
// Mac/Linux系统示例
// System.setProperty("webdriver.chrome.driver", "/usr/local/bin/chromedriver");

WebDriver driver = new ChromeDriver();

2. 通过JVM启动参数设置

如果不想在代码里硬编码路径,可以在运行Java程序的时候,加上JVM参数来指定:

# Windows命令行
java -Dwebdriver.chrome.driver=C:\tools\chromedriver.exe YourTestClass
# Mac/Linux终端
java -Dwebdriver.chrome.driver=/usr/local/bin/chromedriver YourTestClass

3. 添加到系统PATH环境变量(一劳永逸)

把ChromeDriver所在的文件夹路径添加到系统的PATH环境变量中,这样Selenium会自动在PATH里查找ChromeDriver,不用再手动设置系统属性了:

  • Windows:右键「此电脑」→属性→高级系统设置→环境变量,在系统变量的PATH里添加ChromeDriver所在目录。
  • Mac/Linux:在~/.bashrc或~/.zshrc里添加export PATH=$PATH:/path/to/chromedriver-folder,然后执行source ~/.bashrc生效。

额外注意事项

  • 如果你用的是Mac/Linux,别忘了给ChromeDriver添加可执行权限,执行命令:chmod +x /path/to/chromedriver
  • 路径一定要写对,别打错文件名或者目录,Windows下记得用双反斜杠或者正斜杠(比如C:/tools/chromedriver.exe也可以)

内容的提问来源于stack exchange,提问作者Prashant Morade

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.20 10:36:37