配套代码utils/retry.py、tests/test_login_api.py说明本节所有代码示例均来自一个真实的移动端自动化测试项目已做模糊化处理。为什么需要重试移动端测试比 Web 测试更容易出现偶发性失败。以下几种情况在本地和 CI 上反复出现网络波动Appium 调用find_element时底层发起的 HTTP 请求超时抛出TimeoutException: An element could not be located on the page using the given search parameters。元素加载慢页面渲染被动画或懒加载阻塞在元素存在前执行了click()触发NoSuchElementException: An element could not be located。键盘弹出延迟send_keys()执行时输入框尚未获得焦点驱动报InvalidElementStateException: Element must be user-editable to sendKeys。动画未结束页面切换动画仍在运行时点击下一个元素抛出ElementClickInterceptedException: Element is not clickable at point (x, y)。这些失败不是代码逻辑 bug而是环境或时序导致的不稳定。重试 2-3 次后绝大部分情况下用例能正常通过。utils/retry.py提供了retry_on_failure装饰器和RetryHelper工具类来解决这类问题。重试装饰器utils/retry.py中的retry_on_failure是一个装饰器直接加在测试函数或页面操作方法上即可启用自动重试。from utils.retry import retry_on_failure class TestLogin: retry_on_failure(max_attempts3, delay2.0) def test_login_with_retry(self, driver): 带重试的登录测试 from pages.login_page import LoginPage login_page LoginPage(driver) login_page.input_phone_email(test_userexample.com) login_page.input_password(test_password) login_page.click_login_button() assert login_page.is_on_home_page()参数说明max_attempts最大尝试次数包括首次执行默认 3。最后一次失败后不再重试直接抛出异常。delay每次重试间隔单位秒默认 1.0。重试前通过time.sleep(delay)等待。exceptions需要捕获并重试的异常类型元组默认(Exception,)即捕获所有异常。可以精确指定只重试特定异常例如exceptions(TimeoutException, NoSuchElementException)。执行流程首次执行函数成功则直接返回结果。捕获到exceptions中指定的异常时记日志并等待delay秒后重试。第 2~N 次重复上述流程。所有max_attempts次均失败后抛出最后一次捕获的异常。# 精确捕获特定异常避免因 AssertionError 误重试 retry_on_failure(max_attempts3, delay2.0, exceptions(TimeoutException, NoSuchElementException)) def test_element_interaction(self, driver): ...RetryHelper 辅助类除了装饰器utils/retry.py还提供了RetryHelper工具类适用于不能或不想用装饰器的场景——比如在页面对象Page Object的某个方法内部对单个操作做重试。retry_operation对任意可调用对象执行重试适合在 Page Object 中精细控制from utils.retry import RetryHelper class LoginPage: def click_login_with_retry(self): 对单次点击操作做重试不波及整个用例 RetryHelper.retry_operation( self.click_login_button, max_attempts3, delay1.0 )签名retry_operation(operation, max_attempts3, delay1.0, exceptions(Exception,), *args, **kwargs)retry_until_success重试直到满足自定义成功条件适合轮询等待某个状态RetryHelper.retry_until_success( self.click_login_button, max_attempts10, delay0.5, success_conditionlambda: self.is_element_displayed(xpath, //*[text首页]) )success_condition是一个可调用对象返回True视为成功。这对于动画未结束、数据尚在加载的场景非常实用——不是单纯等固定时间而是等到条件成立。重试策略选择策略适用场景参数建议固定延迟网络波动、元素加载慢delay2.0指数退避服务端限流、资源竞争延迟递增2s → 4s → 8s快速重试键盘弹出延迟、动画未结束delay0.5指数退避可以在retry_on_failure基础上手动实现def retry_with_backoff(max_attempts3, base_delay1.0): def decorator(func): wraps(func) def wrapper(*args, **kwargs): last_exception None for attempt in range(max_attempts): try: return func(*args, **kwargs) except Exception as e: last_exception e if attempt max_attempts - 1: delay base_delay * (2 ** attempt) logger.warning(f等待{delay}秒后重试: {e}) time.sleep(delay) raise last_exception return wrapper return decorator常见坑与报错以下是在实际项目中踩过的坑每个都附有具体报错信息。坑 1重试覆盖了真正的代码 bugAssertionError: Expected True but got False assert login_page.is_on_home_page()如果你用retry_on_failure(max_attempts5, delay1.0)不加exceptions参数默认捕获Exception连AssertionError也会被兜住重试。测试报告里显示重试后通过但实际是业务逻辑有问题。应通过exceptions参数限定只重试环境类异常让断言失败直接暴露。坑 2重试间隔太短重试等于白试selenium.common.exceptions.TimeoutException: Message: timeout (WARNING: The server did not provide any stacktrace information)页面上一个接口通常需要 1-3 秒返回数据如果重试间隔设成delay0.3页面还没加载完就重试同样会再次超时。推荐至少 1.5-2 秒。坑 3重试次数太多拖慢整个测试集Test session running in 12m 34s ...100 个用例每个重试 3 次 × 2 秒延迟 多出 600 秒10 分钟。如果每个用例都无脑加retry_on_failure测试集时间膨胀严重。只在确实偶发的用例上加重试能通过find_element加WebDriverWait解决的优先用等待。坑 4装饰器忘了加wrapspytest 报告中函数名变成 wrappertests/test_login.py::test_login_with_retry → wrapper # 函数名被覆盖utils/retry.py中已经写了from functools import wraps并在内层函数上加wraps(func)。如果你自己写重试装饰器时漏了这一行func.__name__会变成wrapperpytest 报告中看到的测试名称将是wrapper而非原始函数名导致无法匹配 Allure 报告中的测试用例。坑 5exceptions参数传了错误类型导致异常逃逸retry_on_failure(max_attempts3, exceptions(TimeoutException))元组写法少了逗号(TimeoutException)会被 Python 解析为单个表达式而非元组。正确的写法是(TimeoutException,)。漏掉逗号后重试装饰器不会捕获任何异常偶发失败直接报错退出。坑 6不适合重试的场景强行加重试AttributeError: NoneType object has no attribute click driver None # driver 未初始化driver为None、测试数据错误、配置写错——这些属于一次性失败重试 100 次结果一样。先定位根因不要用重试掩盖配置或数据问题。哪些场景适合用重试元素定位超时页面加载慢网络请求超时网络波动偶发性断言失败动画未结束元素尚未到达预期状态哪些场景不适合用重试逻辑错误代码 bug重试多少次都一样数据错误测试数据不对重试后仍然一样配置错误driver 没初始化、API 地址不对总结重试是应对移动端测试不稳定性的实用手段但需要搭配正确的参数和策略。utils/retry.py提供了装饰器和工具类两套方案——装饰器适合整个测试函数级别RetryHelper适合细粒度控制单次操作。用好exceptions参数避免误吞断言失败控制delay和max_attempts防止测试集膨胀。能通过显式等待WebDriverWaitexpected_conditions解决的问题优先用等待重试作为兜底方案。
【Appium 系列】第18节-重试与容错 — 移动端测试的稳定性保障
配套代码utils/retry.py、tests/test_login_api.py说明本节所有代码示例均来自一个真实的移动端自动化测试项目已做模糊化处理。为什么需要重试移动端测试比 Web 测试更容易出现偶发性失败。以下几种情况在本地和 CI 上反复出现网络波动Appium 调用find_element时底层发起的 HTTP 请求超时抛出TimeoutException: An element could not be located on the page using the given search parameters。元素加载慢页面渲染被动画或懒加载阻塞在元素存在前执行了click()触发NoSuchElementException: An element could not be located。键盘弹出延迟send_keys()执行时输入框尚未获得焦点驱动报InvalidElementStateException: Element must be user-editable to sendKeys。动画未结束页面切换动画仍在运行时点击下一个元素抛出ElementClickInterceptedException: Element is not clickable at point (x, y)。这些失败不是代码逻辑 bug而是环境或时序导致的不稳定。重试 2-3 次后绝大部分情况下用例能正常通过。utils/retry.py提供了retry_on_failure装饰器和RetryHelper工具类来解决这类问题。重试装饰器utils/retry.py中的retry_on_failure是一个装饰器直接加在测试函数或页面操作方法上即可启用自动重试。from utils.retry import retry_on_failure class TestLogin: retry_on_failure(max_attempts3, delay2.0) def test_login_with_retry(self, driver): 带重试的登录测试 from pages.login_page import LoginPage login_page LoginPage(driver) login_page.input_phone_email(test_userexample.com) login_page.input_password(test_password) login_page.click_login_button() assert login_page.is_on_home_page()参数说明max_attempts最大尝试次数包括首次执行默认 3。最后一次失败后不再重试直接抛出异常。delay每次重试间隔单位秒默认 1.0。重试前通过time.sleep(delay)等待。exceptions需要捕获并重试的异常类型元组默认(Exception,)即捕获所有异常。可以精确指定只重试特定异常例如exceptions(TimeoutException, NoSuchElementException)。执行流程首次执行函数成功则直接返回结果。捕获到exceptions中指定的异常时记日志并等待delay秒后重试。第 2~N 次重复上述流程。所有max_attempts次均失败后抛出最后一次捕获的异常。# 精确捕获特定异常避免因 AssertionError 误重试 retry_on_failure(max_attempts3, delay2.0, exceptions(TimeoutException, NoSuchElementException)) def test_element_interaction(self, driver): ...RetryHelper 辅助类除了装饰器utils/retry.py还提供了RetryHelper工具类适用于不能或不想用装饰器的场景——比如在页面对象Page Object的某个方法内部对单个操作做重试。retry_operation对任意可调用对象执行重试适合在 Page Object 中精细控制from utils.retry import RetryHelper class LoginPage: def click_login_with_retry(self): 对单次点击操作做重试不波及整个用例 RetryHelper.retry_operation( self.click_login_button, max_attempts3, delay1.0 )签名retry_operation(operation, max_attempts3, delay1.0, exceptions(Exception,), *args, **kwargs)retry_until_success重试直到满足自定义成功条件适合轮询等待某个状态RetryHelper.retry_until_success( self.click_login_button, max_attempts10, delay0.5, success_conditionlambda: self.is_element_displayed(xpath, //*[text首页]) )success_condition是一个可调用对象返回True视为成功。这对于动画未结束、数据尚在加载的场景非常实用——不是单纯等固定时间而是等到条件成立。重试策略选择策略适用场景参数建议固定延迟网络波动、元素加载慢delay2.0指数退避服务端限流、资源竞争延迟递增2s → 4s → 8s快速重试键盘弹出延迟、动画未结束delay0.5指数退避可以在retry_on_failure基础上手动实现def retry_with_backoff(max_attempts3, base_delay1.0): def decorator(func): wraps(func) def wrapper(*args, **kwargs): last_exception None for attempt in range(max_attempts): try: return func(*args, **kwargs) except Exception as e: last_exception e if attempt max_attempts - 1: delay base_delay * (2 ** attempt) logger.warning(f等待{delay}秒后重试: {e}) time.sleep(delay) raise last_exception return wrapper return decorator常见坑与报错以下是在实际项目中踩过的坑每个都附有具体报错信息。坑 1重试覆盖了真正的代码 bugAssertionError: Expected True but got False assert login_page.is_on_home_page()如果你用retry_on_failure(max_attempts5, delay1.0)不加exceptions参数默认捕获Exception连AssertionError也会被兜住重试。测试报告里显示重试后通过但实际是业务逻辑有问题。应通过exceptions参数限定只重试环境类异常让断言失败直接暴露。坑 2重试间隔太短重试等于白试selenium.common.exceptions.TimeoutException: Message: timeout (WARNING: The server did not provide any stacktrace information)页面上一个接口通常需要 1-3 秒返回数据如果重试间隔设成delay0.3页面还没加载完就重试同样会再次超时。推荐至少 1.5-2 秒。坑 3重试次数太多拖慢整个测试集Test session running in 12m 34s ...100 个用例每个重试 3 次 × 2 秒延迟 多出 600 秒10 分钟。如果每个用例都无脑加retry_on_failure测试集时间膨胀严重。只在确实偶发的用例上加重试能通过find_element加WebDriverWait解决的优先用等待。坑 4装饰器忘了加wrapspytest 报告中函数名变成 wrappertests/test_login.py::test_login_with_retry → wrapper # 函数名被覆盖utils/retry.py中已经写了from functools import wraps并在内层函数上加wraps(func)。如果你自己写重试装饰器时漏了这一行func.__name__会变成wrapperpytest 报告中看到的测试名称将是wrapper而非原始函数名导致无法匹配 Allure 报告中的测试用例。坑 5exceptions参数传了错误类型导致异常逃逸retry_on_failure(max_attempts3, exceptions(TimeoutException))元组写法少了逗号(TimeoutException)会被 Python 解析为单个表达式而非元组。正确的写法是(TimeoutException,)。漏掉逗号后重试装饰器不会捕获任何异常偶发失败直接报错退出。坑 6不适合重试的场景强行加重试AttributeError: NoneType object has no attribute click driver None # driver 未初始化driver为None、测试数据错误、配置写错——这些属于一次性失败重试 100 次结果一样。先定位根因不要用重试掩盖配置或数据问题。哪些场景适合用重试元素定位超时页面加载慢网络请求超时网络波动偶发性断言失败动画未结束元素尚未到达预期状态哪些场景不适合用重试逻辑错误代码 bug重试多少次都一样数据错误测试数据不对重试后仍然一样配置错误driver 没初始化、API 地址不对总结重试是应对移动端测试不稳定性的实用手段但需要搭配正确的参数和策略。utils/retry.py提供了装饰器和工具类两套方案——装饰器适合整个测试函数级别RetryHelper适合细粒度控制单次操作。用好exceptions参数避免误吞断言失败控制delay和max_attempts防止测试集膨胀。能通过显式等待WebDriverWaitexpected_conditions解决的问题优先用等待重试作为兜底方案。
