本文介绍如何在 PyTest 中优雅地等待异步或后台操作就绪，推荐使用 polling 库实现可配置超时与轮询间隔的 wait-until 语义，避免手动编写循环逻辑，提升测试健壮性与可读性。
本文介绍如何在 pytest 中优雅地等待异步或后台操作就绪，推荐使用 polling 库实现可配置超时与轮询间隔的 `wait-until` 语义，避免手动编写循环逻辑，提升测试健壮性与可读性。
在 PyTest 中测试后台运行或异步启动的操作（如任务提交、状态机切换、服务健康检查等）时，常需“等待某条件成立”，而非简单 await 单个协程。虽然 Python 原生 asyncio.wait_for 适用于等待协程完成，但它不支持对同步可调用条件（如 operation.is_ready()）进行带间隔的轮询——而这正是典型“wait-until”场景的核心需求。
此时，polling 是一个轻量、稳定且专为此设计的第三方库。它提供阻塞式轮询能力，天然兼容同步测试上下文（即普通 def test_... 函数），无需 async def 或事件循环管理，与 PyTest 完全无缝集成。
✅ 快速上手示例
首先安装：
pip install polling
然后在测试中使用：
import polling
import pytest
def test_operation_becomes_ready():
operation = MyAsyncOperation()
operation.run_in_background() # 启动后台任务（同步调用）
timeout_s = 10
interval_s = 1
try:
polling.poll(
lambda: operation.is_ready(), # 条件：返回布尔值
timeout=timeout_s, # 总超时时间（秒）
step=interval_s # 每次重试间隔（秒）
)
except polling.TimeoutException:
pytest.fail(f"Operation did not become ready within {timeout_s}s.")
⚠️ 注意：
polling.poll()默认执行同步轮询，因此要求lambda: operation.is_ready()是同步函数。若is_ready()本身是协程（async def），需先通过asyncio.run()或pytest-asyncio的事件循环注入方式包装——但更推荐将状态检查设计为轻量同步接口，以保持测试简洁性与可预测性。
? 进阶用法提示
- 支持自定义失败判定：通过
check_success=lambda result: result == "success"灵活匹配返回值； - 支持异常忽略：设置
ignore_exceptions=(ConnectionError,)跳过特定异常并继续轮询； - 支持结果提取：
poll(..., step=0.5, max_tries=20)可限制最大尝试次数替代超时。
✅ 总结
polling 库填补了 PyTest 生态中“条件轮询等待”的关键空白。它比手写 while time.time() 更可靠（内置指数退避可选、异常处理完备），比强行引入 <code>asyncio 更轻量（无需 @pytest.mark.asyncio）。对于绝大多数后台任务就绪检测、资源终态验证等场景，它是简洁、可维护、生产就绪的首选方案。
