解决Spring Boot项目中Selenium 4.0依赖版本冲突

问题现象与错误定位

在进行基于Selenium的Web自动化任务（如订饭程序开发）时，如果直接在非Spring Boot环境下引入Selenium 4.0，程序可以正常运行。然而，当项目升级为Spring Boot架构后，启动或运行测试时可能出现以下异常堆栈：

java.lang.NoClassDefFoundError: org/openqa/selenium/internal/Require

Caused by: java.lang.ClassNotFoundException: org.openqa.selenium.internal.Require

该错误表明JVM无法找到Selenium 4.0内部的新类结构。虽然你在项目的 pom.xml 中显式声明了 selenium-java 的版本号为4.0.0，但运行时加载的仍是旧版本库。这是因为Spring Boot提供的 starter 包或父级依赖管理中包含了WebDriver的传递性依赖。

根本原因分析：Maven依赖树冲突

要理解为什么“显式声明”失效，需要查看Maven的依赖解析机制。Spring Boot 通过 spring-boot-dependencies 模块维护一套标准依赖版本表（BOM）。当你引入Spring Boot相关依赖时，这些默认版本会被应用到项目中，除非你采取特定措施进行覆盖。

使用 mvn dependency:tree 命令检查依赖树可以发现，尽管你写了4.0版本，但实际解析出的Selenium版本往往变成了Spring Boot BOM指定的 3.141.59。

进一步查阅Spring Boot源码或官方文档，发现 spring-boot-dependencies 模块中硬编码了Selenium的默认版本为3.141.59。这就导致了你的显式声明被BOM中的默认值“压制”，从而引发了类缺失错误。

解决方案：显式覆盖依赖版本

要让项目正确使用Selenium 4.0，必须显式地告诉Maven忽略BOM中的默认版本。以下是两种有效的修复方式，推荐优先使用第一种。

第1步：在dependencyManagement中强制指定版本

目的：利用Maven的优先级规则，通过 management 块提高版本的权重，使其高于传递性依赖和BOM的默认值。

操作：在项目根目录的 pom.xml 中，添加或修改 <dependencyManagement> 部分：

<dependencyManagement>
    <dependencies>
        <!-- 其他依赖 ... -->
        
        <!-- 强制指定Selenium版本，解决Spring Boot BOM冲突 -->
        <dependency>
            <groupId>org.seleniumhq.selenium</groupId>
            <artifactId>selenium-java</artifactId>
            <version>4.0.0</version> 
        </dependency>
    </dependencies>
</dependencyManagement>

完成状态：执行 mvn clean compile，若不再抛出 NoClassDefFoundError 且依赖树中显示正确版本，则配置生效。

第2步：移除Starter中的传递依赖（可选方案）

如果你使用的是某些特定的Spring Boot Starter集成包，也可以尝试排除其内部的Selenium依赖，再手动引入新版。但在大多数纯Selenium使用中，方案1更为简洁通用。

注意：该方法仅针对Selenium与Spring Boot结合时的版本覆盖冲突。在普通Java应用中，显式声明即可直接生效，无需额外配置管理块。

简要总结

Selenium 4.0在Spring Boot项目中报错 NoClassDefFoundError 的核心原因是Spring Boot BOM强制引入了旧版3.x依赖。通过在 dependencyManagement 中显式声明较新的版本号，可以有效打破这一默认约束。在处理类似第三方库版本冲突时，始终建议先通过 mvn dependency:tree 确认实际加载版本，再针对性地进行版本锁定或排除。

以上就是Spring Boot中解决Selenium 4.0版本冲突的详细内容，更多关于Selenium自动化测试与Spring Boot集成的资料请关注本站其它相关文章！