Python Selenium点击筛选条件后等待失效导致脚本崩溃如何解决？

该问题本质是单页应用(SPA)的局部刷新场景，点击第一个筛选后页面仅重载视图区域，不会触发整页加载，所以常规的document.ready判断、普通的元素可点击等待都可能因为旧DOM还未销毁被误判为条件成立，提前执行下一步操作。

1. 等待旧视图元素销毁（最稳妥） #

第一次点击后，先等待原来的视图区域元素从DOM中移除，再等待第二个要点击的元素加载完成：

from selenium.webdriver.support import expected_conditions as EC
from selenium.common.exceptions import TimeoutException

# 第一次点击操作
first_filter = WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "/html/body/div[1]/form/div[1]/div[2]/div/div[2]/a/img")))
first_filter.click()

# 第一步：等待原有旧视图元素失效（替换为你页面加载时会被销毁的旧视图元素定位，示例用的是第二个点击元素的旧版本定位）
old_element = driver.find_element(By.XPATH, "/html/body/div[4]/div/div[5]")
WebDriverWait(driver, 30).until(EC.staleness_of(old_element))

# 第二步：再等待新渲染的目标元素可点击
WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "/html/body/div[4]/div/div[5]"))).click()

2. 等待加载动画消失（适配有加载状态的站点） #

大部分管理后台筛选刷新时会出现加载遮罩、加载动画这类元素，等待这类元素消失后再执行后续操作即可：

# 第一次点击后，等待加载元素不存在（替换为你站点实际的加载元素定位）
WebDriverWait(driver, 30).until(EC.invisibility_of_element_located((By.CLASS_NAME, "loading-spinner")))

# 再执行第二个点击
WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "/html/body/div[4]/div/div[5]"))).click()

3. 监听接口请求完成（复杂异步场景适用） #

如果上述方案都不生效，可以通过Chrome DevTools的网络面板找到筛选触发的接口请求，用Selenium的性能日志接口等待对应请求返回后再执行后续操作：

from selenium import webdriver
from selenium.webdriver.common.desired_capabilities import DesiredCapabilities
import json
import time

# 初始化driver时开启性能日志
caps = DesiredCapabilities.CHROME
caps['goog:loggingPrefs'] = {'performance': 'ALL'}
driver = webdriver.Chrome(desired_capabilities=caps)

# 封装接口等待方法
def wait_for_api_complete(api_path, timeout=30):
    end_time = time.time() + timeout
    while time.time() < end_time:
        logs = driver.get_log('performance')
        for entry in logs:
            log = json.loads(entry['message'])['message']
            if log['method'] == 'Network.responseReceived' and api_path in log['params']['response']['url']:
                return True
        time.sleep(0.2)
    raise TimeoutException(f"接口{api_path}在{timeout}秒内未完成加载")

# 第一次点击后调用方法等待筛选接口完成，替换为你实际的筛选接口路径
first_filter.click()
wait_for_api_complete("/api/filter/query")
# 再执行第二个点击
WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "/html/body/div[4]/div/div[5]"))).click()

• 尽量不要用绝对路径的XPATH定位，页面结构稍有变动就会失效，建议改用ID、类名、业务属性等相对稳定的定位方式
• 不要用固定时长的time.sleep()，不仅效率低，也容易出现网络波动时等待时长不够的问题

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