Python失败重跑：pytest-rerunfailures自动重试

橘子海

发布时间：2026-09-10 | 6人浏览过

原创

安装插件并配置基础重试

pytest-rerunfailures是一款专为处理偶发性测试失败设计的pytest插件。其核心用途是在测试用例执行失败后，自动按预设次数重新运行该用例，从而过滤掉因网络抖动、资源竞争或环境瞬时异常导致的误报。安装方式极为简便，只需在终端执行pip install pytest-rerunfailures即可完成依赖下载与注册。安装完成后，无需修改原有测试代码，即可通过命令行参数直接启用重试机制。例如，运行pytest --reruns 3表示当任意测试用例首次失败时，插件将自动追加最多三次重试机会。该配置作用于全局，适用于快速验证测试套件的稳定性。在实际工程中，建议将重试次数控制在合理范围（通常为2至5次），以避免过度消耗CI/CD资源。

展示终端中安装pytest-rerunfailures并运行pytest --reruns命令的真实操作截图 — 终端中执行 pip install pytest-rerunfailures 完成插件安装。

运行测试并验证重试行为

执行带有重试参数的测试时，可通过pytest tests/ --reruns 2启动验证流程。在终端输出中，插件会明确标记每次重试的状态：首次失败后，控制台会打印RERUN标识，并显示当前重试进度。若重试过程中用例通过，最终结果将标记为PASSED，并在统计摘要中计入成功用例；若所有重试次数耗尽仍未通过，则标记为FAILED。需要注意的是，重试行为会直接增加测试的总执行次数。例如，一个包含10个用例的套件，若其中2个用例各触发2次重试，实际执行次数将变为14次。通过观察pytest输出的rerun统计行与passed/failed汇总，开发者可清晰判断用例是偶发恢复还是持续失败，从而为后续优化提供数据支撑。

展示pytest测试失败后自动重跑并输出rerun信息的真实终端截图 — pytest 运行失败用例后显示 RERUN，并在最终摘要中标明重试次数。

按场景调整重试策略

针对不同业务场景，合理配置重试参数是提升测试有效性的关键。--reruns控制最大重试次数，而--reruns-delay则用于设置两次重试之间的等待时间（单位为秒）。例如，在涉及外部API调用的网络测试中，可执行pytest --reruns 3 --reruns-delay 5，给予服务端足够的恢复窗口；对于UI自动化测试，页面渲染或元素加载常需更长时间，建议将延迟调至10秒以上，并配合显式等待机制；异步任务或消息队列测试则可能需要结合--reruns-delay与业务轮询逻辑，避免在任务尚未完成时盲目重试。此外，这些参数可持久化写入pyproject.toml或pytest.ini的配置段中，实现团队统一规范。通过场景化调优，既能提升通过率，又能控制执行耗时。

展示pytest命令参数或项目配置文件中设置重试次数和延迟的真实代码截图 — 终端日志展示 reruns 与 reruns_delay 配置生效后的重试过程和最终失败结果。

识别并避免重试掩盖真实问题

重试机制绝非万能药，盲目依赖极易掩盖真实缺陷。对于断言逻辑错误、代码逻辑漏洞或环境配置缺失等确定性失败，重试毫无意义，反而会浪费排查时间。判断是否存在真实缺陷，应结合测试日志、失败频率与重试结果综合分析：若某用例在多次重试中始终失败，且日志抛出明确的异常堆栈，则应优先修复代码而非增加重试次数。同时，严禁设置过高的重试阈值或试图实现无限重试，这会导致CI流水线阻塞并掩盖系统级风险。建议对已知偶发用例使用@pytest.mark.flaky(reruns=3)进行精准标记，并定期审查重试报告，将通过重试恢复的用例纳入稳定性治理清单，从根本上消除不确定性。