Selenium Java：为何Page Factory中WebElement List返回空，Page Object则正常？

问题场景 #

1. 直接使用driver.findElements（POM模式） #

以下代码可正常输出预期的列表大小6：

int noOfLinks = driver.findElements(By.xpath("//p[@class='_78mc9p']")).size();
System.out.println(noOfLinks);

2. 使用Page Factory的@FindBy注解 #

相同XPath下，返回的列表大小为0：

// Page类中的元素定义
@FindBy(xpath = "//p[@class='_78mc9p']")
public List<WebElement> noOfLinks;

// Page类中的计数方法
public int countLinks(){
    return noOfLinks.size();
}

// 测试代码
ObjName.countLinks();
System.out.println(ObjName.countLinks());

核心疑问：相同XPath在两种方式下结果不同，@FindBy的工作机制是否存在差异？

原因分析与解决办法 #

核心差异：元素定位时机 #

• driver.findElements()是在代码调用时才执行元素查找，此时页面通常已完成渲染，能找到动态加载的元素。
• Page Factory默认的@FindBy是在Page对象初始化时就执行元素定位，如果此时页面还未完全加载、元素尚未渲染，就会返回空列表（size=0）。

解决办法 #

1. 启用懒加载+超时等待
   在Page类的构造方法中，使用AjaxElementLocatorFactory实现懒加载，让元素在第一次被调用时才去查找，并且设置超时时间：

   public YourPage(WebDriver driver) {
       this.driver = driver;
       // 设置10秒的元素查找超时，可根据实际调整
       PageFactory.initElements(new AjaxElementLocatorFactory(driver, 10), this);
   }
   

2. 确保页面加载完成后再初始化Page对象
   在测试代码中，先等待目标元素或页面关键元素加载完成，再创建Page实例：

   WebDriverWait wait = new WebDriverWait(driver, 10);
   // 等待目标元素可见
   wait.until(ExpectedConditions.visibilityOfElementLocated(By.xpath("//p[@class='_78mc9p']")));
   // 初始化Page对象
   YourPage ObjName = new YourPage(driver);
   System.out.println(ObjName.countLinks());
   

3. 检查上下文切换（如iframe/shadow DOM）
   如果目标元素位于iframe或shadow DOM中，需要先切换到对应上下文，再初始化Page对象，否则@FindBy无法定位到元素。

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