Selenium代码本地可捕获StaleElementReferenceException，Jenkins中无法捕获如何解决？

问题根因 #

• 异常被包装导致捕获失效：Jenkins运行环境中使用的是EventFiringWebDriver封装类，而非本地测试用的原生FirefoxDriver，原始的StaleElementReferenceException会被外层包装为WebDriverException抛出。你的代码仅捕获了StaleElementReferenceException，无法命中包装后的异常，最终导致程序中断。
• 环境时序差异：Jenkins节点为Linux系统下的无头模式火狐，页面渲染、DOM更新的时序和本地有头浏览器存在明显差异，元素失效的触发概率更高，进一步暴露了捕获逻辑的缺陷。
• 权限/目录缺失问题：日志中存在java.io.IOException: No such file or directory报错，说明Jenkins运行账号缺少对应目录的读写权限，或配置的缓存/存储路径不存在，也会触发外层WebDriverException。

解决方案 #

1. 调整异常捕获逻辑，同时兼容原生异常和包装后的异常：

try {
  // 注意检查此处xpath不要有多余的右括号，避免语法错误
  driver.findElement(By.xpath("//div/table[@class='v-table-table']/descendant::tr/td[1]")).click();
} catch (StaleElementReferenceException e) {
  // 原有Stale元素异常处理逻辑，例如重试定位点击
} catch (WebDriverException e) {
  // 判断异常根因是否为元素失效
  if (e.getCause() instanceof StaleElementReferenceException || e.getMessage().contains("stale element reference")) {
    // 执行Stale元素对应的处理逻辑
  } else if (e.getMessage().contains("No such file or directory")) {
    // 处理目录权限/缺失问题
  } else {
    // 其他WebDriver异常处理
  }
}

2. 增加元素操作重试机制，规避单次操作失效问题：

// 通用重试点击方法，最多重试3次
public void retryClick(By locator) throws InterruptedException {
  int maxRetry = 3;
  int retryCount = 0;
  while (retryCount < maxRetry) {
    try {
      driver.findElement(locator).click();
      return;
    } catch (Exception e) {
      retryCount++;
      if (retryCount >= maxRetry) {
        throw e;
      }
      // 短等待后重试，避免频繁操作
      Thread.sleep(100);
    }
  }
}

3. 修复IO异常问题：

• 检查Jenkins运行账号对/tmp目录的读写权限，确保geckodriver可以正常创建临时火狐配置文件
• 检查代码中配置的截图、文件下载等存储路径，确认路径在Jenkins节点上真实存在，且运行账号有读写权限

4. 对齐本地与Jenkins的运行配置：本地测试时也使用相同版本的无头火狐、geckodriver和Selenium依赖，减少环境差异导致的不可控问题。

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