Selenium 实战指南：Web UI 自动化测试中的异常处理策略

Web UI 自动化测试中，异常处理是保证测试稳定性和可靠性的关键。Selenium 提供了多种机制来应对动态页面元素、网络延迟或异步加载等问题。以下是一些核心策略和实践方法。

---

显式等待与隐式等待的合理使用

显式等待通过 WebDriverWait 和 expected_conditions 实现，针对特定条件（如元素可见性或可点击性）设置等待时间。隐式等待通过 driver.implicitly_wait() 设置全局等待时间，但可能导致不必要的延迟。

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

# 显式等待示例
element = WebDriverWait(driver, 10).until(
    EC.presence_of_element_located((By.ID, "dynamic-element"))
)

隐式等待通常与显式等待混合使用，但需注意避免冲突。显式等待优先于隐式等待。

---

异常捕获与自定义错误处理

Selenium 常见异常包括 NoSuchElementException、TimeoutException 和 StaleElementReferenceException。通过 try-except 块捕获异常并记录日志，可以增强脚本的健壮性。

from selenium.common.exceptions import NoSuchElementException

try:
    element = driver.find_element(By.ID, "non-existent-element")
except NoSuchElementException as e:
    print(f"元素未找到: {e}")
    # 可选：截图保存当前页面状态
    driver.save_screenshot("error.png")

自定义错误处理可以结合日志模块（如 logging）记录详细上下文信息，便于后续分析。

---

动态元素与 Stale 状态处理

动态页面中，元素可能因 DOM 更新而失效。通过重新定位或刷新页面上下文解决 StaleElementReferenceException。

from selenium.common.exceptions import StaleElementReferenceException

def safe_click(element_locator, max_retries=3):
    for _ in range(max_retries):
        try:
            driver.find_element(*element_locator).click()
            break
        except StaleElementReferenceException:
            continue

对于频繁更新的元素，建议每次操作前重新定位，而非缓存元素对象。

---

页面加载策略与超时配置

通过 pageLoadStrategy 设置页面加载策略（如 none、eager 或 normal），平衡测试速度和稳定性。结合 set_script_timeout 和 set_page_load_timeout 控制脚本和页面加载超时。

from selenium import webdriver

options = webdriver.ChromeOptions()
options.page_load_strategy = "eager"  # 仅等待DOM加载完成
driver = webdriver.Chrome(options=options)
driver.set_page_load_timeout(10)  # 页面加载超时10秒

此策略适用于对页面资源依赖性较低的测试场景。

---

重试机制与容错设计

通过装饰器或工具类实现自动化重试逻辑，应对偶发性问题（如网络波动）。

import time
from functools import wraps

def retry_on_failure(max_attempts=3, delay=1):
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            for attempt in range(max_attempts):
                try:
                    return func(*args, **kwargs)
                except Exception as e:
                    if attempt == max_attempts - 1:
                        raise
                    time.sleep(delay)
        return wrapper
    return decorator

@retry_on_failure()
def click_element(locator):
    driver.find_element(*locator).click()

重试间隔应逐步递增（如指数退避），避免加重系统负担。

---

总结

有效的异常处理策略需结合显式等待、异常捕获、动态元素管理和重试机制。通过合理配置超时参数和日志记录，可以显著提升测试脚本的稳定性和可维护性。实际应用中，应根据项目需求灵活调整策略，确保自动化测试的高效执行。