Selenium WebDriver偶现Stale Element Exception问题排查求助

使用Selenium WebDriver v4.3搭配Selenium-wire v5.1，以无头模式运行Chrome 112.0.5615.49时，频繁出现Stale Element Exception（过时元素异常），仅偶尔能正常通过ID定位按钮并点击。已尝试ID、CSS、CLASS、TAG等多种定位方式，问题仍存在。

驱动初始化代码 #

def setup(request, cmdopt):
    chrome_options = Options()
    chrome_options.add_argument('--headless')
    chrome_options.add_argument('--no-sandbox')
    chrome_options.add_experimental_option("detach", True)
    chrome_options.add_argument("start-maximized")
    chrome_options.add_argument("window-size=1920,1080")
    service = Service('/usr/bin/chromedriver')
    service.logging_path = '/home/admin/logs/chromedriver.log'
    global driver
    driver = webdriver.Chrome(options=chrome_options, seleniumwire_options=seleniumwire_options,
                              executable_path='/usr/bin/chromedriver', service=service)
    wait = WebDriverWait(driver, 60)
    driver.maximize_window()
    request.cls.driver = driver
    request.cls.wait = wait
    request.cls.environment = cmdopt
    request.cls.traceid_and_bookingid = None
    yield
    driver.quit()

元素访问代码 #

try:
    self.wait.until(EC.presence_of_element_located((By.XPATH, "//button[@id='unique ID']"))).click()
except Exception as e:
    print(e)
    self.wait.until(
        EC.presence_of_element_located((By.XPATH, "//button[@id='unique ID']"))).click()

核心原因 #

Stale Element Exception本质是元素的DOM引用已失效——可能是页面刷新、元素被前端框架重新渲染、元素被删除后又重建，导致之前定位到的元素对象和当前DOM中的元素不匹配。

针对性解决方法 #

1. 替换等待条件，确保元素可交互
   当前用的presence_of_element_located仅保证元素在DOM中存在，但不代表元素可见、可点击。改用element_to_be_clickable，它会同时等待元素存在、可见且可交互，避免因元素未完全渲染就点击引发的异常；同时直接用By.ID定位比XPATH更高效：

   self.wait.until(EC.element_to_be_clickable((By.ID, "unique ID"))).click()
   

2. 封装重试机制，处理动态DOM变化
   即使加了等待，页面仍可能在等待完成后发生DOM更新，导致元素过时。可以封装一个带重试的点击方法，捕获StaleElementReferenceException并重试：

   from selenium.common.exceptions import StaleElementReferenceException
   
   def click_with_retry(self, locator, retries=3):
       for _ in range(retries):
           try:
               element = self.wait.until(EC.element_to_be_clickable(locator))
               element.click()
               return
           except StaleElementReferenceException:
               continue
       raise Exception(f"重试{retries}次后仍无法点击元素")
   
   # 调用方式
   self.click_with_retry((By.ID, "unique ID"))
   

3. 修复无头模式的配置冲突
   你当前同时设置了start-maximized和window-size参数，可能导致窗口尺寸异常，影响页面渲染。建议保留其中一个；同时给无头模式添加--disable-gpu参数，避免部分环境的渲染差异：

   chrome_options.add_argument('--headless=new')  # 新版无头模式更接近有头行为
   chrome_options.add_argument('--disable-gpu')
   # 保留一个窗口尺寸参数即可
   chrome_options.add_argument("window-size=1920,1080")
   

4. 排查Selenium-wire的干扰
   Selenium-wire会拦截网络请求，可能影响页面加载速度或JS执行时机。可以暂时禁用它，看问题是否消失：

   # 注释掉seleniumwire_options参数
   driver = webdriver.Chrome(options=chrome_options, executable_path='/usr/bin/chromedriver', service=service)
   

   如果禁用后问题解决，需调整Selenium-wire配置，比如添加请求过滤规则，避免拦截关键资源导致页面渲染异常。

5. 等待页面动态更新完成
   若目标按钮所在页面存在AJAX请求或前端组件更新，可在点击前等待关键请求完成，确保DOM稳定：

   # 示例：通过Selenium-wire等待指定请求完成
   for request in self.driver.requests:
       if "关键接口URL" in request.url and request.response:
           break
   

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