Spring整合Selenium时GeckoDriver路径未设置问题排查

问题描述 #

在Spring项目中尝试用WebDriverManager自动管理GeckoDriver，按照教程配置后，仍抛出错误：

The path to the driver executable must be set by the webdriver.gecko.driver system property

相关代码文件 #

Controller类 #

@Controller
@RequestMapping
@AllArgsConstructor
public class HomeController {

    private final ParseData parseArsenkin;


    @GetMapping("/")
    public String getHome(){
        return "home";
    }

    @PostMapping("/")
    public String postHome(){
        parseArsenkin.parse();
        return "result";
    }
}

WebDriverConfig配置类 #

@Configuration
public class WebDriverConfig {

    @Bean
    public FirefoxDriver firefoxDriver() {
        WebDriverManager.firefoxdriver().setup();
        return new FirefoxDriver();
    }
}

ParseData服务类 #

@Service
@AllArgsConstructor
public class ParseData {
    private final FirefoxDriver firefoxDriver;
    public void parse() {
        String baseUrl = "http://google.com";
        firefoxDriver.get(baseUrl);
        System.out.println();
    }
}

错误堆栈信息 #

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'homeController' defined in file [/home/michael/Documents/JavaProjects/positions/target/classes/ru/pcask/positions/controller/HomeController.class]: Unsatisfied dependency expressed through constructor parameter 0; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'parseArsenkin' defined in file [/home/michael/Documents/JavaProjects/positions/target/classes/ru/pcask/positions/service/ParseArsenkin.class]: Unsatisfied dependency expressed through constructor parameter 0; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'firefoxDriver' defined in class path resource [ru/pcask/positions/configuration/WebDriverConfig.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.openqa.selenium.firefox.FirefoxDriver]: Factory method 'firefoxDriver' threw exception; nested exception is java.lang.IllegalStateException: The path to the driver executable must be set by the webdriver.gecko.driver system property

排查与解决步骤 #

• 版本兼容性问题：检查WebDriverManager与Selenium版本是否匹配。WebDriverManager 5.x系列对应Selenium 4.x，若使用旧版本组合会导致驱动配置失效，需同步升级或降级至兼容版本。
• 手动指定驱动版本：如果自动版本检测失败，可在setup时手动指定GeckoDriver版本：

  @Bean
  public FirefoxDriver firefoxDriver() {
      WebDriverManager.firefoxdriver().browserVersion("115.0").setup();
      return new FirefoxDriver();
  }
  

• 改用FirefoxOptions初始化驱动：新版本Selenium推荐通过FirefoxOptions配置，确保WebDriverManager设置的路径被正确识别：

  @Bean
  public FirefoxDriver firefoxDriver() {
      WebDriverManager.firefoxdriver().setup();
      FirefoxOptions options = new FirefoxOptions();
      // 可选：添加无头模式等配置，如options.addArguments("--headless");
      return new FirefoxDriver(options);
  }
  

• 确认依赖正确引入：确保WebDriverManager依赖已加入项目：
  Maven依赖：

  <dependency>
      <groupId>io.github.bonigarcia</groupId>
      <artifactId>webdrivermanager</artifactId>
      <version>5.6.3</version> <!-- 使用最新兼容版本 -->
  </dependency>
  

  Gradle依赖：

  implementation 'io.github.bonigarcia:webdrivermanager:5.6.3'
  

• 清理驱动缓存：若本地缓存的GeckoDriver文件损坏，删除默认缓存目录（~/.cache/selenium）后重新运行项目，让WebDriverManager重新下载驱动。

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