Spring与Selenium依赖冲突求助：添加依赖后抛NoClassDefFoundError

这是典型的依赖版本冲突导致的问题，我之前帮同事排查过类似情况：你没写Spring代码但添加了Spring依赖后，Spring的间接依赖会悄悄引入和你当前使用的Selenium版本不兼容的旧版Selenium组件，而org.openqa.selenium.MutableCapabilities是Selenium 3.x及以后版本才有的类，如果被旧版（比如2.x）覆盖，就会抛出这个错误。

下面是具体的解决步骤：

• 第一步：排查依赖树，找到冲突源
  用构建工具的依赖树命令，找出哪个Spring依赖引入了旧版Selenium：

  • Maven用户执行：

    mvn dependency:tree
    

  • Gradle用户执行：

    ./gradlew dependencies
    

  搜索输出中的org.seleniumhq.selenium，就能看到所有引入的Selenium版本，找到和你自己声明的版本不一致的那个，定位到对应的Spring依赖。

• 第二步：排除冲突的旧版Selenium依赖
  在引入Spring依赖的地方，排除掉旧版的Selenium模块。比如如果是Spring Boot Starter引入的冲突，Maven的配置示例：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.seleniumhq.selenium</groupId>
              <artifactId>selenium-api</artifactId>
          </exclusion>
          <!-- 如果还有其他冲突的selenium模块（比如selenium-remote-driver），也一起排除 -->
      </exclusions>
  </dependency>
  

  Gradle的配置示例：

  implementation('org.springframework.boot:spring-boot-starter-web') {
      exclude group: 'org.seleniumhq.selenium', module: 'selenium-api'
  }
  

• 第三步：锁定你的目标Selenium版本
  为了避免后续其他依赖再引入冲突版本，建议在项目中明确锁定Selenium的版本：

  • Maven可以在dependencyManagement中声明：

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.seleniumhq.selenium</groupId>
                <artifactId>selenium-java</artifactId>
                <version>你的目标版本，比如4.15.0</version>
            </dependency>
        </dependencies>
    </dependencyManagement>
    

  • Gradle可以用强制版本的方式：

    configurations.all {
        resolutionStrategy.force 'org.seleniumhq.selenium:selenium-java:4.15.0'
    }
    

• 第四步：清理依赖缓存并重新构建
  有时候本地依赖缓存会有残留问题，执行清理命令后重新构建：

  • Maven：

    mvn clean install -U
    

  • Gradle：

    ./gradlew clean build --refresh-dependencies
    

做完这些步骤后，再运行你的Selenium代码，应该就能解决NoClassDefFoundError的问题了。

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