Python Selenium中Try块内WebDriverWait报错问题

问题现状 #

使用Python Selenium编写自动化脚本时，尝试用Try/Except块捕获点击按钮的异常，但代码仍会在Try块内中断，触发TimeoutException。脚本多次迭代执行时，每N次就会出现一次该问题。

相关代码片段 #

...
###### click left bar option
select_element(driver, By.CSS_SELECTOR, "a[id='mnu_Matrícula']")

###### click suboption
select_element(driver, By.XPATH, "//*[@id='2020']")
time.sleep(20)
            
try:
    # click new creation
    WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "/html/body/div[1]/div[1]/div[1]/div/div[1]/div[1]/app-panel/div/div[2]/div/button"))).click()
    # select_element(driver, By.XPATH, "/html/body/div[1]/div[1]/div[1]/div/div[1]/div[1]/app-panel/div/div[2]/div/button")
    time.sleep(10)
except:
    status = "ERROR"

...

报错信息 #

Cell In[23], line 121
   119 try:
   120     # click new creation
---> 121     WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "/html/body/div[1]/div[1]/div[1]/div/div[1]/div[1]/app-panel/div/div[2]/div/button"))).click()
   122     #select_element(driver, By.XPATH, "/html/body/div[1]/div[1]/div[1]/div/div[1]/div[1]/app-panel/div/div[2]/div/button")

   raise TimeoutException(message, screen, stacktrace)

问题原因分析 #

1. 裸Except可能未正确捕获异常：虽然用了except:，但某些环境下TimeoutException可能未被正确拦截；或者自定义的select_element函数内部存在未处理异常，导致在进入Try块前就中断执行。
2. 绝对XPATH定位不稳定：从根节点开始的绝对XPATH极度依赖页面DOM结构，一旦页面有微小变化（比如新增节点），就会定位失败触发超时。
3. 固定Sleep不可靠：time.sleep(20)是固定等待时间，若服务器偶尔响应慢，页面加载未完成就执行后续操作，直接导致元素定位超时。

解决方案 #

1. 明确捕获指定异常 #

不要用裸except:，明确捕获Selenium相关异常，确保异常被正确拦截：

from selenium.common.exceptions import TimeoutException, ElementClickInterceptedException

# ... 其他代码 ...
try:
    WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "优化后的定位路径"))).click()
    time.sleep(10)
except (TimeoutException, ElementClickInterceptedException, Exception) as e:
    status = "ERROR"
    print(f"异常信息: {str(e)}")  # 可选：打印异常便于排查

2. 优化元素定位方式 #

替换脆弱的绝对XPATH为相对定位，比如根据按钮文本、class或父容器属性定位：

# 示例：根据按钮文本定位（假设按钮文本为"新建"）
WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "//button[contains(text(), '新建')]"))).click()

# 示例：根据父容器class定位
WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "//div[@class='panel-content']/button"))).click()

3. 替换固定Sleep为显式等待 #

点击子选项后，不要用固定等待，而是等待目标区域的关键元素加载完成，确保页面就绪：

# 点击子选项后，等待目标面板加载
select_element(driver, By.XPATH, "//*[@id='2020']")
WebDriverWait(driver, 30).until(EC.presence_of_element_located((By.XPATH, "//app-panel/div/div[2]")))

# 再执行后续点击操作
try:
    WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "优化后的路径"))).click()
    # ...

4. 增加重试机制 #

针对偶尔出现的超时，在异常捕获中加入重试逻辑，避免单次失败就标记错误：

max_retries = 2
retry_count = 0
status = "SUCCESS"

while retry_count <= max_retries:
    try:
        WebDriverWait(driver, 30).until(EC.element_to_be_clickable((By.XPATH, "优化后的路径"))).click()
        time.sleep(10)
        break
    except (TimeoutException, Exception) as e:
        retry_count += 1
        if retry_count > max_retries:
            status = "ERROR"
            print(f"重试{max_retries}次后仍失败: {str(e)}")

5. 检查自定义select_element函数 #

确认select_element内部是否存在未处理异常，若该函数直接抛出异常，会在进入Try块前中断脚本。可以在函数内部加异常处理，或者调用时包裹Try/Except：

# 示例：调用select_element时加入异常捕获
try:
    select_element(driver, By.CSS_SELECTOR, "a[id='mnu_Matrícula']")
    select_element(driver, By.XPATH, "//*[@id='2020']")
except Exception as e:
    print(f"点击侧边栏选项失败: {str(e)}")
    status = "ERROR"

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