解决Selenium点击元素时的StaleElementReferenceException问题

StaleElementReferenceException本质是你之前获取的元素引用因页面DOM重新渲染（比如刷新、动态加载）而失效。要确保元素一处于可点击状态就完成点击，核心思路是每次尝试点击前都重新获取最新的元素引用，同时增加重试机制处理偶发异常。

优化后的代码实现 #

可以封装一个重试点击的函数，每次重试都重新等待元素可点击，避免旧引用失效：

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

def click_when_clickable(driver, locator, timeout=15, max_retries=3):
    retries = 0
    while retries < max_retries:
        try:
            # 每次重试都重新等待元素进入可点击状态，获取最新的DOM引用
            target_btn = WebDriverWait(driver, timeout).until(
                EC.element_to_be_clickable(locator)
            )
            # 优先使用原生click，若存在遮挡等问题再换成execute_script
            target_btn.click()
            # driver.execute_script("arguments[0].click();", target_btn)
            return True
        except StaleElementReferenceException:
            retries += 1
            print(f"元素引用过时，重试第 {retries} 次")
        except TimeoutException:
            print("超时未找到可点击的目标元素")
            driver.quit()
            return False
    print(f"已重试 {max_retries} 次，点击仍失败")
    return False

# 调用示例
click_when_clickable(driver, (By.LINK_TEXT, 'TRANSFERÊNCIA'))

关键优化点 #

• 每次重试重新获取元素：不再提前保存元素引用，而是每次都通过WebDriverWait重新获取最新的DOM元素，从根源避免引用过时问题。
• 多重试机制：设置max_retries处理偶发的DOM更新，比单次重试更可靠。
• 坚持使用element_to_be_clickable：这个条件同时验证元素存在、可见且可点击，比presence_of_element_located更严谨，确保点击操作能成功执行。

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