如何修复Selenium的StaleElementReferenceError元素引用失效报错

StaleElementReferenceError的本质是你拿到的元素引用对应的DOM节点，已经被从当前页面文档中移除了。你的代码里有两个直接触发问题的写法：

• 所有Selenium异步操作都没有加等待，代码执行时序完全不可控：driver.get()、click()、sendKeys()都是异步Promise操作，你没有等前序操作执行完成、页面状态稳定就直接执行下一步查找元素的逻辑，点击登录按钮后页面会发生跳转/重渲染，旧DOM会被整体销毁，你提前拿到的旧页面body引用会直接失效。
• 你之前尝试的修复代码完全没有改动原有逻辑，只是重复写了一遍失效的getText调用，自然不可能解决问题。

• 把业务函数改成async异步函数，所有Selenium的异步操作前都加await，保证操作按顺序执行，避免时序错乱。
• 点击登录按钮后，加显式等待逻辑，等登录后的页面标志性元素加载完成（证明DOM重渲染/跳转已经结束），再重新查找body元素获取文本，不要复用页面刷新前拿到的旧元素引用。
• 尽量不要用/html/xxx这种绝对路径XPath选择器，页面结构轻微变动就会导致选择器失效，优先用元素id、固定属性做定位。

修复后的完整函数代码如下：

const { By, until } = require('selenium-webdriver');

async function eduMobile(driver) {
  // 等待初始页面加载完成
  await driver.get(process.env.URL);
  
  // 执行PIN登录流程，每一步等待操作完成
  const pinEntry = await driver.findElement(By.id('inputPin'));
  await pinEntry.sendKeys(process.env.PIN);

  const pinOkBtn = await driver.findElement(By.xpath('//form/input[@type="submit"]'));
  await pinOkBtn.click();

  // 等待登录后页面加载完成：把下面的选择器换成你登录后页面才会出现的专属元素即可，超时时间设为10秒
  await driver.wait(until.elementLocated(By.id('userDashboard')), 10000, '登录后页面加载超时');

  // 页面稳定后重新查找body元素，再获取文本
  const mobile_body = await driver.findElement(By.tagName('body'));
  const bodyText = await mobile_body.getText();
  console.log(bodyText);
}

• 只要页面发生过跳转、DOM整体重渲染，之前通过findElement拿到的所有元素引用都会失效，必须在页面稳定后重新查找元素，不要图省事复用旧引用。
• 无头模式下页面加载速度和有头模式有差异，必须加显式等待控制流程，不要靠固定时长的sleep等页面，稳定性会很差。

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