Selenium PageFactory@FindBy初始化List<WebElement>空指针异常排查

核心原因 #

NullPointerException的本质是ArgumentsProvider的执行时机早于页面对象元素的初始化时机，或者在ArgumentsProvider中使用的页面对象实例未正确完成PageFactory初始化：

1. TestNG会提前实例化ArgumentsProvider，此时WebDriver可能还未创建，页面对象的@FindBy元素自然未被初始化，导致列表为null。
2. 若在ArgumentsProvider中自行new BankPageFactory但未调用PageFactory.initElements()或传入无效WebDriver，元素列表不会被赋值。
3. 测试类中初始化的页面对象实例与ArgumentsProvider中使用的实例不是同一个，后者未完成初始化。

解决方案 #

方案1：在ArgumentsProvider内正确初始化页面对象 #

直接在provideArguments方法中创建/获取有效WebDriver，再初始化页面对象：

public class RateArgumentsProvider implements ArgumentsProvider {
    @Override
    public Object[] provideArguments(Method method, ITestContext context) {
        // 从TestContext获取已初始化的WebDriver（推荐），或自行实例化
        WebDriver driver = (WebDriver) context.getAttribute("testDriver");
        
        // 初始化页面对象
        BankPageFactory bankPage = PageFactory.initElements(driver, BankPageFactory.class);
        
        // 安全访问元素列表
        return new Object[]{bankPage.saleRate, bankPage.purchaseRate};
    }
}

配套测试类设置（在@BeforeTest中初始化WebDriver并存入TestContext）：

public class BankTest {
    @BeforeTest
    public void initDriver(ITestContext context) {
        WebDriver driver = new ChromeDriver();
        context.setAttribute("testDriver", driver);
        driver.get("你的银行页面URL");
    }
}

方案2：提前初始化页面对象并共享到TestContext #

在测试类的前置方法中完成WebDriver和页面对象的初始化，存入TestContext，ArgumentsProvider直接取用已初始化的实例：

// 测试类
public class BankTest {
    @BeforeTest
    public void setUp(ITestContext context) {
        WebDriver driver = new ChromeDriver();
        BankPageFactory bankPage = PageFactory.initElements(driver, BankPageFactory.class);
        driver.get("你的银行页面URL");
        // 将初始化好的页面对象存入TestContext
        context.setAttribute("initializedBankPage", bankPage);
    }

    @Test(dataProviderClass = RateArgumentsProvider.class)
    public void verifyRates(List<WebElement> saleRates, List<WebElement> purchaseRates) {
        // 测试逻辑
    }
}

// ArgumentsProvider实现
public class RateArgumentsProvider implements ArgumentsProvider {
    @Override
    public Object[] provideArguments(Method method, ITestContext context) {
        BankPageFactory bankPage = (BankPageFactory) context.getAttribute("initializedBankPage");
        if (bankPage == null) {
            throw new IllegalStateException("页面对象未在TestContext中初始化");
        }
        return new Object[]{bankPage.getSaleRate(), bankPage.getPurchaseRate()};
    }
}

方案3：改用DataProvider结合页面对象（更符合POM设计） #

若ArgumentsProvider仅用于提供测试数据，推荐直接在DataProvider中访问测试类已初始化的页面对象，避免跨实例问题：

public class BankTest {
    private WebDriver driver;
    private BankPageFactory bankPage;

    @BeforeMethod
    public void setUp() {
        driver = new ChromeDriver();
        bankPage = PageFactory.initElements(driver, BankPageFactory.class);
        driver.get("你的银行页面URL");
    }

    @DataProvider(name = "rateData")
    public Object[] getRateData() {
        // 直接使用已初始化的页面对象
        return new Object[]{bankPage.saleRate, bankPage.purchaseRate};
    }

    @Test(dataProvider = "rateData")
    public void testRates(List<WebElement> saleRates, List<WebElement> purchaseRates) {
        // 测试逻辑
    }
}

关键排查点 #

• 确认@FindBy的定位符（如@FindBy(xpath = "//div[@class='rate']")）是否正确，避免因定位错误导致元素列表为空（但空列表不会触发NPE，仅会在后续操作时无元素）。
• 确保PageFactory.initElements()传入的WebDriver实例不为null，且已加载目标页面。

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