Selenium Java启动Firefox报错：需配置webdriver.gecko.driver系统属性

这个错误的核心原因是未正确指定geckodriver可执行文件的路径，以下是几种可靠的解决方式：

1. 在代码中直接设置系统属性 #

在初始化FirefoxDriver之前，通过System.setProperty()指定geckodriver的绝对路径：

public class Demo_QA {
    public static void main(String[] args) {
        // 替换为你本地geckodriver.exe的实际路径
        System.setProperty("webdriver.gecko.driver", "C:\\tools\\geckodriver-v0.31.0-win64\\geckodriver.exe");
        FirefoxDriver driver = new FirefoxDriver();
        
        // 执行你的测试操作...
        
        driver.quit();
    }
}

注意：Windows系统路径需用双反斜杠\\转义，或直接使用正斜杠/。

2. 通过JVM启动参数设置 #

运行Java程序时，在VM参数中添加驱动路径配置：

-Dwebdriver.gecko.driver=C:\tools\geckodriver-v0.31.0-win64\geckodriver.exe

如果使用IDE（如IntelliJ IDEA、Eclipse），可在运行配置的「VM选项」栏中添加该行参数。

3. 将geckodriver加入系统PATH环境变量 #

把geckodriver.exe放到系统环境变量PATH已包含的目录下（比如C:\Windows\System32），这样Selenium会自动检索到驱动，无需手动设置系统属性。

额外注意 #

确认你的Firefox浏览器版本与geckodriver-v0.31.0兼容（geckodriver官方文档会标注支持的Firefox版本范围），避免因版本不匹配引发其他问题。

内容的提问来源于stack exchange，提问作者KelmiImashi