Selenium从3.141升级到4.7.0后PageFactory初始化报NoSuchMethodError

问题描述 #

将Selenium从3.141版本升级到4.7.0/4.7.1版本后，使用PageFactory初始化页面元素时抛出NoSuchMethodError异常。

依赖配置 #

<!-- https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java -->
<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.7.1</version>
</dependency>

初始化代码 #

public WebElementsLogin(WebDriver driver) {
    this.driver = driver;
    PageFactory.initElements(this.driver, this);
}

异常信息 #

java.lang.NoSuchMethodError: 'void org.openqa.selenium.support.PageFactory.initElements(org.openqa.selenium.SearchContext, java.lang.Object)'

解决办法 #

这个异常的核心原因是依赖冲突：项目中同时存在旧版本（3.x）的selenium-support包和新版本的selenium-java包，导致JVM加载了旧版本的PageFactory类，而旧版本的initElements方法签名与新版本不兼容。

具体解决步骤：

• 排查并清理依赖冲突：
  执行依赖分析命令：Maven用户用mvn dependency:tree，Gradle用户用./gradlew dependencies，找出所有引入selenium-support的依赖项。如果发现第三方依赖间接引入了3.x版本的selenium-support，在对应依赖中添加排除规则：

  <dependency>
      <!-- 替换为实际的第三方依赖信息 -->
      <groupId>com.example</groupId>
      <artifactId>third-party-lib</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.seleniumhq.selenium</groupId>
              <artifactId>selenium-support</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 确保依赖完整性：
  Selenium 4.x的selenium-java已经包含selenium-support模块，无需单独引入旧版本的selenium-support依赖，直接移除项目中单独添加的该依赖项。
• 清理构建缓存：
  Maven执行mvn clean install -U，Gradle执行./gradlew clean build --refresh-dependencies，强制更新依赖并清理本地缓存。
• 验证方法调用：
  你的代码调用的initElements(WebDriver, Object)在Selenium 4.x中仍保持兼容，若依赖清理后仍报错，可尝试显式指定元素定位工厂：

  PageFactory.initElements(new DefaultElementLocatorFactory(driver), this);
  

内容的提问来源于stack exchange，提问作者Muhammad Abu Bakar