Java 20环境下Selenium Java项目初始化Firefox及geckodriver适配问题

一、初始化 Firefox 浏览器 #

依赖准备（Maven 示例） #

确保项目引入对应版本的 Selenium 依赖：

<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.10.0</version>
</dependency>
<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-firefox-driver</artifactId>
    <version>4.10.0</version>
</dependency>

初始化代码 #

方式1：自动驱动管理（推荐）

Selenium 4.6+ 内置驱动自动管理，无需手动配置驱动路径：

import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.firefox.FirefoxOptions;

public class FirefoxSetup {
    public static void main(String[] args) {
        // 可选：配置浏览器启动参数，比如无头模式
        FirefoxOptions options = new FirefoxOptions();
        options.addArguments("--headless");

        // 初始化浏览器实例
        FirefoxDriver driver = new FirefoxDriver(options);

        // 示例操作
        driver.get("https://example.com");
        System.out.println(driver.getTitle());

        // 关闭浏览器
        driver.quit();
    }
}

方式2：手动指定驱动路径

如果自动管理失效，可手动设置 Geckodriver 路径：

import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.firefox.FirefoxOptions;
import org.openqa.selenium.firefox.GeckoDriverService;

public class FirefoxManualSetup {
    public static void main(String[] args) {
        // 替换为你的 Geckodriver 实际路径
        System.setProperty(GeckoDriverService.GECKO_DRIVER_EXE_PROPERTY, "/usr/local/bin/geckodriver");

        FirefoxOptions options = new FirefoxOptions();
        FirefoxDriver driver = new FirefoxDriver(options);

        driver.get("https://example.com");
        driver.quit();
    }
}

二、Geckodriver 版本适配与错误解决 #

错误原因 #

你遇到的 Exception in thread "main" org.openqa.selenium.remote.NoSuchDriverException: geckodriver located at path, but invalid 是因为 Geckodriver 0.33.0 与 Firefox 114 版本不兼容：Geckodriver 0.33.0 仅支持 Firefox 115 及以上版本，无法适配你的 Firefox 114。

正确版本选择 #

适配 Firefox 114 的 Geckodriver 版本为 0.32.2（该版本支持 Firefox 102 ~ 114 全系列版本，完全匹配你的环境）。

优化建议 #

优先使用 Selenium 的自动驱动管理功能（方式1），它会自动检测浏览器版本并匹配对应 Geckodriver，避免手动版本适配的麻烦。

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