Alpine Docker中使用Selenium FirefoxDriver报java.lang.NoClassDefFoundError

1 修复Selenium依赖版本冲突 #

你当前的报错核心是java.lang.NoClassDefFoundError: org/openqa/selenium/remote/RemoteWebElement，由pom文件中Selenium相关依赖版本不匹配导致：

• 你同时引入了4.0.0版本的selenium-java、selenium-api，以及早已停止维护的2.0b1版本selenium-common，从报错日志可见实际加载的selenium-remote-driver为3.141.59版本，多版本混布导致类加载异常。
• 解决方案：
  • 直接删除pom中单独引入的selenium-api、selenium-common两个依赖，selenium-java已经包含所有Selenium核心组件，无需额外单独引入子模块
  • 如需固定版本，可统一所有Selenium相关依赖为同一版本，推荐和firefox-esr兼容的3.141.59或4.0+稳定版

2 修复Xvfb启动配置错误 #

你当前Dockerfile中RUN Xvfb :9 &的配置不生效：RUN指令仅在镜像构建阶段执行，构建完成后该进程就会终止，容器运行时不存在对应的X服务，DISPLAY环境变量指向无效地址。

• 解决方案二选一：
  • 方案1（推荐，无需手动管理X服务）：使用xvfb-run包装启动命令，修改Dockerfile的CMD为：

    CMD ["xvfb-run", "-a", "mvn", "spring-boot:run"]
    

    该方式会自动分配可用的DISPLAY端口，无需额外配置环境变量
  • 方案2：编写启动脚本同时拉起Xvfb和Spring Boot服务，将脚本设为容器启动入口

3 可选优化：使用Firefox无头模式跳过X服务依赖 #

直接在初始化FirefoxDriver时添加无头模式参数，无需安装xvfb，资源占用更低也更稳定：

@Scheduled(fixedRate = 20000)
public void main() throws InterruptedException, IOException {
    System.setProperty("webdriver.gecko.driver", "Gecko/geckodriver");
    QueueEntity queue = QueueDAO.next();
    if (queue != null) {
        FirefoxOptions options = new FirefoxOptions();
        options.addArguments("--headless", "--no-sandbox", "--disable-gpu");
        WebDriver driver = new FirefoxDriver(options);
        // 原有业务逻辑
    }
}

4 其他校验项 #

• 给geckodriver添加执行权限，在Dockerfile中增加指令：RUN chmod +x /app/Gecko/geckodriver
• 确认geckodriver版本和firefox-esr、Selenium版本兼容：Selenium4.x要求geckodriver 0.30+、firefox 78+版本

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