Python Selenium 实现重试逻辑处理StaleElementReferenceException

• WebDriverWait默认仅忽略NoSuchElementException，不会自动捕获等待过程中出现的StaleElementReferenceException，一旦定位到的元素刚拿到引用就被DOM动态替换，会直接中断等待逻辑，触发外层异常
• 异常捕获粒度存在疏漏：原逻辑没有区分异常类型，非Stale的错误（比如定位器写错、元素被隐藏）也会被无意义地重试，既拉长执行时间，还容易掩盖真实报错
• 缺少兜底容错：当前循环走完所有重试次数后，不会抛出明确的错误提示，脚本会带着空值继续执行，很容易在后续环节出现无上下文的空指针报错，排查成本极高
• 等待策略效率偏低：每次重试都重新走完整的10秒等待窗口，没有结合Stale异常的触发频率调整等待逻辑，整体执行效率偏低

完全对齐核心需求：最多重试指定次数，任意一次全链路定位未触发Stale异常就立刻退出循环，仅对Stale异常做重试，其他异常直接向上抛出。

from selenium.common.exceptions import StaleElementReferenceException
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.common.by import By
import time

# 可配置参数
MAX_RETRY = 5  # 最大重试次数，即需求中提到的指定x次
WAIT_TIMEOUT = 10
RETRY_INTERVAL = 2

tableText = None  # 初始化目标返回值，和原有变量名保持一致

for _ in range(MAX_RETRY):
    try:
        # 把Stale异常加入WebDriverWait的忽略列表，让等待窗口内出现的元素失效问题自动重试
        wait = WebDriverWait(
            driver,
            WAIT_TIMEOUT,
            ignored_exceptions=[StaleElementReferenceException]
        )
        # 全链路元素定位
        table = wait.until(EC.visibility_of_element_located((By.ID, "实际table的ID值")))
        body = table.find_element(By.CLASS_NAME, "实际的table body类名")
        tableText = body.find_elements(By.TAG_NAME, "tr")

        # 走到这里说明全链路定位无异常，直接跳出循环
        break
    except StaleElementReferenceException:
        # 仅对Stale异常做重试，其他异常不进入捕获逻辑
        time.sleep(RETRY_INTERVAL)
else:
    # 循环走完所有重试次数仍未成功时，抛出明确的报错信息
    raise RuntimeError(f"经{MAX_RETRY}次重试，仍因DOM动态更新无法定位目标表格元素")

• 尽量减少元素对象的持有时间：拿到行元素引用后，不要长期把元素对象存在全局变量中，优先提取需要的文本、属性值；如果只是要获取表格全部文本，可以直接用table.get_attribute("innerText")读取，减少链式定位触发Stale的概率
• 把重试逻辑封装为通用工具：将带Stale重试的元素定位逻辑抽成独立函数，后续所有动态元素定位场景都可以复用，避免重复编写try/except循环
• 优化重试等待策略：将固定的2秒重试间隔调整为指数退避（第一次等0.5s，第二次1s，第三次2s），减少无效等待时长
• 定位时优先稳定的定位策略：尽量用ID、唯一的aria属性定位，避免依赖容易变动的class、层级关系，从根源减少DOM变动触发的Stale异常

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