Selenium中Try Except未捕获TimeoutException问题求助

问题场景 #

使用Selenium操作Salesforce批量添加州/省信息时，代码正常运行但每千次操作会触发一次内部服务器错误。尝试用try/except语句捕获TimeoutException但未生效，已确认导入selenium.common.exceptions.TimeoutException模块。

相关代码 #

from selenium.common.exceptions import TimeoutException

# 点击保存按钮后可能触发服务器错误
driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id43:addButton').click()

# 尝试捕获异常的逻辑
try:
    WebDriverWait(driver, 30).until(EC.presence_of_element_located((By.CSS_SELECTOR, '.msgIcon'))) # 报错行
except TimeoutException:
    print('Internal Server Error')
    driver.refresh()
    driver.find_element(By.ID, 'configurecountry:form:stateRelatedListComponent:configStateCountryRelList:list:j_id50:buttonAddNew').click()
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id9:nameSectionItem:editName').click()
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id9:nameSectionItem:editName').send_keys(countriesAndStates[countryCode][stateCode])
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id9:codeSectionItem:editIsoCode').click()
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id9:codeSectionItem:editIsoCode').send_keys(stateCode)
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id9:activeSectionItem:editActive').click()

报错信息 #

发生异常: TimeoutException
第249行，位于WebDriverWait(driver,30).until(EC.presence_of_element_located((By.CSS_SELECTOR,'.msgIcon')))
selenium.common.exceptions.TimeoutException

未捕获异常的核心原因 #

• 异常作用域覆盖不全：当前try块仅包裹了WebDriverWait等待操作，但点击保存按钮后，页面可能在跳转、加载阶段就因服务器错误抛出TimeoutException，这部分操作不在try范围内，无法被捕获。
• 潜在的命名冲突：若代码中自定义了同名的TimeoutException类，会覆盖Selenium导入的异常类，导致捕获逻辑失效。
• 外层异常拦截：如果这段代码嵌套在另一个try/except块中，外层的异常捕获逻辑可能先拦截了TimeoutException，导致当前except分支无法执行。

解决办法 #

1. 扩大异常监控范围 #

将可能触发服务器错误的前置操作（如点击保存按钮）也纳入try块，确保所有风险步骤都被覆盖：

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

try:
    # 把点击保存按钮纳入try范围
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id43:addButton').click()
    WebDriverWait(driver, 30).until(EC.presence_of_element_located((By.CSS_SELECTOR, '.msgIcon')))
except TimeoutException:
    print('Internal Server Error')
    driver.refresh()
    # 重新执行添加流程
    driver.find_element(By.ID, 'configurecountry:form:stateRelatedListComponent:configStateCountryRelList:list:j_id50:buttonAddNew').click()
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id9:nameSectionItem:editName').send_keys(countriesAndStates[countryCode][stateCode])
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id9:codeSectionItem:editIsoCode').send_keys(stateCode)
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id9:activeSectionItem:editActive').click()

2. 排查异常类型 #

添加通用异常捕获分支，确认是否有其他类型异常被抛出：

except TimeoutException:
    print('捕获到TimeoutException，处理内部服务器错误')
    # 处理逻辑
except Exception as e:
    print(f'捕获到其他异常: {type(e).__name__}: {str(e)}')
    # 可选：记录日志或重新抛出

3. 确认异常类的正确性 #

检查代码中是否存在自定义的TimeoutException类，避免与Selenium的异常类命名冲突；同时确保导入路径正确：

# 正确导入方式
from selenium.common.exceptions import TimeoutException

4. 增加页面状态校验 #

在等待元素前，先校验页面是否正常加载，比如检查Salesforce服务器错误页面的特定标识：

try:
    driver.find_element(By.ID, 'configurenew:j_id1:blockNew:j_id43:addButton').click()
    # 先检查是否出现服务器错误页面
    WebDriverWait(driver, 5).until(EC.presence_of_element_located((By.CSS_SELECTOR, '.serverError')))
    print('直接检测到服务器错误')
    # 执行重试逻辑
except TimeoutException:
    # 未检测到错误，继续等待目标元素
    try:
        WebDriverWait(driver, 25).until(EC.presence_of_element_located((By.CSS_SELECTOR, '.msgIcon')))
    except TimeoutException:
        print('超时未找到目标元素，判定为服务器错误')
        # 执行重试逻辑

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