Java Selenium非Page Factory模式下解决返回页面的StaleElementReferenceException

1. 每次操作前重新定位元素 #

别提前缓存元素引用，每次需要点击按钮时，都通过定位器（比如By.id/By.xpath）重新查找元素。因为返回页面后DOM会重新渲染，之前的元素引用已经失效，重新查找能拿到最新的元素实例，从根儿上避免StaleElementReferenceException。

示例代码：

// 只定义定位器，不提前查元素
private By addCandidateBtnLocator = By.id("add-candidate-btn");

// 点击方法：每次都重新获取元素
public void clickAddCandidateBtn() {
    driver.findElement(addCandidateBtnLocator).click();
}

不管是首次进入页面还是返回后，调用这个方法都能正常点击。

2. 封装通用的重试点击工具方法 #

如果不想每个用例都写重复的异常捕获逻辑，可以封装一个工具方法，专门处理点击操作的StaleElement异常，复用性更强。

示例代码：

public void retryClick(By locator, int maxAttempts) {
    int attempts = 0;
    while (attempts < maxAttempts) {
        try {
            driver.findElement(locator).click();
            return;
        } catch (StaleElementReferenceException e) {
            attempts++;
            // 可选：短暂等待给DOM刷新时间
            try {
                Thread.sleep(500);
            } catch (InterruptedException ie) {
                Thread.currentThread().interrupt();
            }
        }
    }
    throw new RuntimeException("尝试" + maxAttempts + "次后仍无法点击元素");
}

// 使用方式
retryClick(addCandidateBtnLocator, 3);

3. 用显式等待配合elementToBeClickable #

你之前说忽略异常的等待没生效，大概率是用错了等待条件。试试ExpectedConditions.elementToBeClickable，这个条件会循环重新查找元素，直到元素可见且可点击，自动处理DOM刷新后的元素引用问题。

示例代码：

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
wait.until(ExpectedConditions.elementToBeClickable(addCandidateBtnLocator)).click();

要是之前用的是presenceOfElementLocated，可能会出现元素存在但已失效的情况，换成elementToBeClickable更稳妥。

补充：之前等待失效的原因 #

如果之前写的是这种错误的等待逻辑：

// 错误示例：基于已失效的元素引用做等待
WebElement btn = driver.findElement(addCandidateBtnLocator);
wait.ignoring(StaleElementReferenceException.class).until(d -> btn.isDisplayed());

即使忽略异常，元素引用还是失效的。正确的写法应该在等待逻辑里每次重新查找元素：

// 正确但没必要的写法，不如直接用elementToBeClickable
wait.ignoring(StaleElementReferenceException.class)
    .until(d -> d.findElement(addCandidateBtnLocator).isDisplayed());

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