使用Selenium TestNG运行程序报java.lang.NullPointerException如何解决

报错信息：java.lang.NullPointerException: Cannot invoke "org.openqa.selenium.WebElement.getTagName()" because "element" is null

这个错误的核心是代码执行到调用WebElement的getTagName()方法时，对应的元素对象为null，没有被成功初始化或找到，可按以下步骤逐一排查修复：

• 排查PageObject类的元素初始化逻辑
  你使用的PrivacyshieldForm是页面对象类，必须在类的构造方法中调用PageFactory.initElements(driver, this)完成注解元素的初始化，如果漏掉这行代码，所有@FindBy注解绑定的元素默认都是null，调用对应操作方法时就会抛出空指针。构造方法参考写法：

  public class PrivacyshieldForm {
      WebDriver driver;
      public PrivacyshieldForm(WebDriver driver) {
          this.driver = driver;
          PageFactory.initElements(driver, this); // 必须加这行初始化元素
      }
      // 后续元素定义和方法代码
  }
  

• 排查元素定位的稳定性
  你代码中使用的ID如pt1:r1:0:it9::content属于前端框架生成的动态ID，ID中的数字序号可能随页面加载状态变化，导致定位失败返回null。建议替换为更稳定的定位方式，比如使用CSS模糊匹配：

  // 匹配ID中包含it9::content的元素，不受前面动态序号影响
  By.cssSelector("[id*='it9::content']")
  

• 修复等待逻辑混用问题
  Selenium官方不推荐显式等待和隐式等待混用，会导致等待时间计算混乱，可能元素还未加载完成就执行查找操作返回null。建议删除代码中的隐式等待配置driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(30));，所有元素操作前都用显式等待确认元素加载完成，比如提交表单后判断元素是否显示的代码可以修改为：

  // 先显式等待目标元素可见，再进行判断
  wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("pt1:r1:1:s1:it1::content")));
  Assert.assertTrue(driver.findElement(By.id("pt1:r1:1:s1:it1::content")).isDisplayed());
  

• 修复明显的逻辑错误
  代码中连续两次调用ps.setemailname()方法，第二次传入确认邮箱的参数属于逻辑错误，应该调用对应确认邮箱输入框的赋值方法，否则表单提交失败会导致后续页面元素找不到。

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