pytest不按定义顺序执行测试,因其设计哲学要求测试相互独立,收集后会打乱或哈希排序以避免隐式依赖;需用pytest-ordering插件通过order、before、after显式控制顺序。

pytest 默认不保证测试函数执行顺序,想靠函数名或定义顺序控制执行是靠不住的;必须用 pytest-ordering 这类插件显式声明优先级。
为什么 pytest 不按定义顺序跑测试?
pytest 的设计哲学是“测试应相互独立”,所以它会把所有 test_* 函数收集完后打乱(或按内部 hash 排序)执行,避免隐式依赖。你看到的“似乎按顺序跑”,只是巧合——换环境、升级 pytest、加新测试都可能打破它。
常见错误现象:
• 本地跑通过,CI 上失败
• test_login 在 test_logout 之后执行,导致 session 失效
• 用 time.sleep(1) 强行串行,结果更不稳定
怎么用 pytest-ordering 设置权重和先后关系?
安装后,直接在测试函数上加装饰器即可,不需要改配置文件或命令行参数:
立即学习“Python免费学习笔记(深入)”;
pip install pytest-ordering
支持三种控制粒度:
-
@pytest.mark.run(order=1):数字越小越早执行,负数也合法(如order=-5) -
@pytest.mark.run(before="test_payment"):确保当前测试在指定函数名之前运行 -
@pytest.mark.run(after="test_setup"):确保在指定函数名之后运行
注意:before/after 中的函数名必须是完整、带模块前缀的(如 test_api.test_user_login),否则会静默失效;推荐优先用 order,更直观可控。
多个标记混用时谁生效?
pytest-ordering 内部有明确优先级:先处理 before/after 约束,再按 order 填空。但一旦出现循环依赖(比如 A before B,B before A),pytest 会直接报错并退出:
ERROR: Cycle detected in test ordering: test_a -> test_b -> test_a
实际使用建议:
- 同一组强依赖的测试(如初始化 → 主流程 → 清理),用
order统一编号,比如order=1,order=2,order=3 - 跨文件的依赖慎用
before/after,容易因导入顺序或 pytest 收集路径变化而失效 - 不要给所有测试都加顺序标记——只约束真正有依赖的部分,其余保持默认随机,反而更容易暴露隐藏耦合
order 值重复或缺失会怎样?
重复没问题:order=2 的多个测试会按 pytest 默认规则(通常是字母序)彼此排序;缺失也没问题:没标 order 的测试统一放在最后,内部再随机。
但要注意一个坑:order 是全局生效的,不是按 class 或文件隔离。如果你在 test_api.py 里写了 order=10,又在 test_ui.py 里写了 order=5,后者一定先执行——哪怕你本意是“各自文件内有序”。
所以复杂项目里,建议用命名空间前缀区分逻辑组:order=101(登录相关)、order=201(支付相关),留出整百区间方便插队。


















