Java Selenium封装TakesScreenshot截图方法报空指针异常如何解决

封装为static方法后抛出空指针，核心问题是静态方法内引用的driver实例未被正确赋值：

• 静态方法归属于类本身，不会自动持有你测试流程中后续初始化的非静态WebDriver对象
• 你在静态方法中直接使用的driver是未初始化的null值，执行(TakesScreenshot) driver强转操作时，访问null对象的方法就会触发空指针异常
• 额外问题：原方法名TakesScreenshot()使用大驼峰命名，不符合Java方法小驼峰的命名规范。

推荐将已初始化的WebDriver实例作为入参传入工具方法，这种写法耦合度低、线程安全，适合多用例、多线程的测试场景，同时补充非空校验、自动时间戳防重名等通用能力。

import org.apache.commons.io.FileUtils;
import org.openqa.selenium.OutputType;
import org.openqa.selenium.TakesScreenshot;
import org.openqa.selenium.WebDriver;
import java.io.File;
import java.io.IOException;
import java.text.SimpleDateFormat;
import java.util.Date;

public class ScreenshotUtils {

    /**
     * 执行页面截图并保存到本地
     * @param driver 已完成初始化的WebDriver实例，不可为null
     * @param savePath 截图存储的文件夹绝对路径
     * @param screenshotName 截图文件标识名（无需加后缀，自动拼接时间戳和.png后缀）
     * @return 截图最终存储的绝对路径，执行失败返回null
     */
    public static String takeScreenshot(WebDriver driver, String savePath, String screenshotName) {
        // 前置非空校验，提前拦截空指针
        if (driver == null) {
            System.out.println("截图失败：WebDriver实例未初始化");
            return null;
        }

        // 调用Selenium内置截图能力
        File srcScreenshot = ((TakesScreenshot) driver).getScreenshotAs(OutputType.FILE);
        // 拼接时间戳生成唯一文件名，避免同名文件被覆盖
        String timeSuffix = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
        File targetFile = new File(savePath + File.separator + screenshotName + "_" + timeSuffix + ".png");

        try {
            FileUtils.copyFile(srcScreenshot, targetFile);
            return targetFile.getAbsolutePath();
        } catch (IOException e) {
            System.out.println("截图保存失败：" + e.getMessage());
            return null;
        }
    }
}

在测试逻辑中，等WebDriver初始化完成、目标页面加载完毕后，传入参数调用即可：

// 测试流程中初始化driver
WebDriver driver = new ChromeDriver();
driver.get("https://你的测试页面地址");
// 页面加载完成后调用截图
String screenshotLocation = ScreenshotUtils.takeScreenshot(driver, "C:\\projectScreenshots", "homePage");

• 不推荐在工具类中硬编码静态WebDriver成员的实现方式：这种写法耦合度极高，多线程并行执行测试用例时会出现实例串扰、截图错位的问题
• 截图操作建议加显式等待，等页面核心元素加载完成后再执行，避免截到空白页面
• 如果使用Selenium 4以上版本，也可以直接用driver.getScreenshotAs()方法，无需再做TakesScreenshot强转，逻辑更简洁。

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