Serenity+Selenium框架调用PageFactory.initElements抛出InvocationTargetException异常

根因说明 #

java.lang.reflect.InvocationTargetException 是反射调用异常，本质不是PageFactory.initElements方法本身出错，是该方法反射实例化你指定的页面对象类时，页面对象的构造方法/初始化逻辑抛出了异常，被反射机制包装后抛出。

具体问题及修复方案 #

• 1. 修正BasePageHelper类的初始化顺序错误
     原构造方法中this.wait = wait代码存在逻辑错误：右侧的wait是未初始化的类成员变量，赋值后wait直接为null，如果你的页面对象初始化逻辑用到了该变量会直接触发空指针，是最常见的报错原因。同时需移除WebDriver、WebDriverWait等对象的static修饰符，避免Serenity多用例并行运行时出现Driver串扰、初始化空值问题。另外原代码类定义缺少泛型T的声明，也会触发类型转换异常。
• 2. 确保页面对象类存在无参构造方法
     Selenium 3.x版本的PageFactory.initElements传入Class对象时，会默认调用类的无参构造方法完成实例化，如果你自定义的页面对象类只声明了带参构造、没有显式定义无参构造，会直接触发实例化失败。
• 3. 排查Selenium版本依赖冲突
     Serenity 2.4.24本身内置了对应版本的Selenium依赖，如果你手动指定了Selenium 3.141.59版本，需要排查依赖冲突，确保所有Selenium相关依赖（selenium-api、selenium-support、selenium-remote-driver等）版本统一为3.141.59，版本不兼容也会触发初始化异常。
• 4. 增加根因打印快速定位问题
     可以在初始化页面对象的代码处增加异常捕获，直接打印反射异常的根因，无需盲猜问题。

修复后代码示例 #

BasePageHelper类 #

// 类声明处增加泛型定义
public abstract class BasePageHelper<T> {
    // 移除static修饰符
    public WebDriver webDriver;
    public SeleniumWait seleniumWait;
    public WebDriverWait wait;
    private T pageObject;


    @SuppressWarnings("unchecked")
    public BasePageHelper(WebDriver driver) {
        // 先初始化当前Helper的成员变量，再初始化页面对象
        this.webDriver = driver;
        // 显式初始化WebDriverWait，超时时间可根据需要调整
        this.wait = new WebDriverWait(driver, 10);
        seleniumWait = new SeleniumWait(webDriver);
        try {
            pageObject = (T) PageFactory.initElements(driver, getPageObjectClass());
        } catch (RuntimeException e) {
            // 打印根因直接定位问题
            System.err.println("页面对象初始化根异常：" + e.getCause());
            throw e;
        }
    }


    private Class<?> getPageObjectClass() {
        if (!getClass().isAnnotationPresent(PageObject.class)) {
            throw new RuntimeException("PageObject annotation must be present on a test helper class");
        } else {            
            return getClass().getAnnotation(PageObject.class).pageObjectClass();
        }
    }
}

页面对象类示例 #

// 所有页面对象类必须显式声明无参构造方法
public class DemoPage {
    @FindBy(id = "demo-input")
    private WebElement demoInput;

    // 显式声明无参构造，供PageFactory反射调用
    public DemoPage() {}

    // 自定义业务方法
    public void inputContent(String content) {
        demoInput.sendKeys(content);
    }
}

依赖冲突排查（Maven） #

在项目pom.xml所在目录执行以下命令，检查Selenium相关依赖版本是否统一：

mvn dependency:tree | grep selenium

如果存在版本不一致，给Serenity依赖增加exclusion排除内置的Selenium依赖即可。

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