如何检查HTML元素是否附着在页面文档，解决selenium stale element报错

首先纠正认知误区：NoSuchElementException无法直接规避元素脱离文档的报错，二者触发场景完全不同：

NoSuchElementException：执行find_element/find_elements定位操作时，当前DOM内没有匹配节点会抛出该异常
StaleElementReferenceException：你已经获取到的WebElement对象对应的DOM节点被移除/替换，此时访问该对象的属性、调用方法都会抛出该异常

方案1：捕获异常+重试逻辑 #

如果你需要保留旧的元素定位逻辑，可以通过捕获StaleElementReferenceException，触发时重新定位元素再操作，示例代码如下：

from selenium import webdriver
from selenium.common.exceptions import StaleElementReferenceException, NoSuchElementException
from selenium.webdriver.common.by import By
import time

driver = webdriver.Chrome()
# 你的元素定位表达式，比如要检查所有class为target的元素
TARGET_SELECTOR = ".target"
MAX_RETRY = 3

while True:
    retry_count = 0
    elements = []
    # 先获取最新的元素列表
    while retry_count < MAX_RETRY:
        try:
            elements = driver.find_elements(By.CSS_SELECTOR, TARGET_SELECTOR)
            break
        except NoSuchElementException:
            retry_count += 1
            time.sleep(0.2)
    
    # 遍历检查每个元素属性
    for idx, elem in enumerate(elements):
        elem_retry = 0
        while elem_retry < MAX_RETRY:
            try:
                # 读取你需要的属性，比如href、class等
                attr_value = elem.get_attribute("class")
                # 这里写你的属性检查逻辑
                print(f"元素{idx}的属性值：{attr_value}")
                break
            except StaleElementReferenceException:
                # 元素失效，重新获取该位置的元素
                elem_retry += 1
                elements = driver.find_elements(By.CSS_SELECTOR, TARGET_SELECTOR)
                if idx < len(elements):
                    elem = elements[idx]
                time.sleep(0.1)

方案2：每次循环重新拉取元素（从根源避免问题） #

对于批量持续检查的场景，最稳妥的方式是不缓存WebElement对象，每次循环都重新执行定位操作获取最新的DOM节点引用，完全避免用到失效元素：

from selenium import webdriver
from selenium.webdriver.common.by import By
import time

driver = webdriver.Chrome()
TARGET_SELECTOR = ".target"

while True:
    # 每次循环都重新获取最新的元素列表，不用之前缓存的对象
    current_elements = driver.find_elements(By.CSS_SELECTOR, TARGET_SELECTOR)
    for elem in current_elements:
        # 直接操作最新获取的元素，几乎不会出现stale异常
        attr_value = elem.get_attribute("class")
        # 你的检查逻辑
        print(attr_value)
    # 按需设置检查间隔
    time.sleep(1)

额外优化建议 #

• 不要长时间缓存WebElement对象，该对象只是DOM节点的临时引用，只要DOM结构发生刷新、节点被替换就会失效
• 如果元素是异步加载更新的，可以搭配WebDriverWait的staleness_of预期条件，等旧元素失效后再操作新元素
• 检测到页面有刷新、列表异步更新的操作后，主动等待100~300ms再执行元素操作，能大幅降低异常出现概率

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