Cucumber框架中WebDriver为空引发NullPointerException问题排查

核心原因 #

报错java.lang.NullPointerException: Cannot invoke "org.openqa.selenium.WebDriver.findElement(...)" because "this.driver" is null，本质是你创建OffersPage实例时传入的testContextSetup.driver本身就是null，导致OffersPage类里的driver字段未被正确赋值，调用searchItem方法时触发空指针异常。

排查与修复步骤 #

1. 确认testContextSetup中的driver已正确初始化 #

检查TestContextSetup类，确保在测试场景启动时完成WebDriver的初始化，比如通过Cucumber的@Before钩子：

public class TestContextSetup {
    public WebDriver driver;

    @Before
    public void initDriver() {
        // 以Chrome为例初始化浏览器驱动
        driver = new ChromeDriver();
        driver.manage().window().maximize();
    }

    @After
    public void quitDriver() {
        if (driver != null) {
            driver.quit();
        }
    }
}

确保@Before注解的方法会在所有Step执行前运行，且driver没有被其他代码意外置为null。

2. 验证testContextSetup实例已注入到StepDefinition中 #

如果StepDefinition类没有通过依赖注入获取TestContextSetup实例，直接使用会导致testContextSetup本身为null，进而testContextSetup.driver也为null。需要通过构造函数注入：

public class OfferPageStepDefinition {
    private TestContextSetup testContextSetup;
    private String offerPageProductName;

    // 构造函数注入TestContextSetup实例
    public OfferPageStepDefinition(TestContextSetup testContextSetup) {
        this.testContextSetup = testContextSetup;
    }

    // ... 其他Step方法
}

注：Cucumber默认支持PicoContainer依赖注入，只要TestContextSetup是公共类且有默认构造函数，Cucumber会自动管理其实例并注入到StepDefinition中。

3. 检查switchToOffersPage()方法的正确性 #

如果该方法用来切换到新打开的Offers页面窗口，需确保切换逻辑正确，且依赖的driver已初始化：

private void switchToOffersPage() {
    Set<String> windowHandles = testContextSetup.driver.getWindowHandles();
    // 切换到非原窗口的新窗口
    for (String handle : windowHandles) {
        testContextSetup.driver.switchTo().window(handle);
        // 通过页面标题/URL判断是否为目标页面
        if (testContextSetup.driver.getTitle().contains("Offers")) {
            break;
        }
    }
}

这一步的前提是testContextSetup.driver已正常初始化，否则切换逻辑也会报错。

4. 确保OffersPage构造函数的访问权限 #

将OffersPage的构造函数改为public，避免包访问权限导致的潜在问题：

public class OffersPage {
    public WebDriver driver;

    // 改为public构造函数
    public OffersPage(WebDriver driver) {
        this.driver = driver;
    }

    // ... 其他方法
}

快速验证技巧 #

在StepDefinition的new OffersPage(testContextSetup.driver)代码前添加打印，直接查看testContextSetup.driver是否为null：

System.out.println("TestContextSetup Driver: " + testContextSetup.driver);
OffersPage offersPage = new OffersPage(testContextSetup.driver);

如果输出为null，优先排查前面的1、2步骤；如果不为null，再检查窗口切换逻辑是否导致driver失去对当前页面的控制。

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