pytest-ordering的@pytest.mark.run(order=...)不生效的根本原因是未显式启用排序功能,需通过配置文件或命令行参数(如--order-scope=session)激活,否则标记被忽略。

pytest-ordering 的 @pytest.mark.run(order=...) 为什么有时不生效
根本原因不是插件坏了,而是 pytest 默认按文件/函数名字母序执行,@pytest.mark.run 只在启用排序时才起作用。没显式开启,标记就等于白写。
实操建议:
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成,提供 184 种工具和 200 多条命令,用于安全分析和代码质量...
- 必须在
pytest.ini、pyproject.toml或命令行中启用插件:加--order-scope=session(或function/module) - 避免混用多个排序标记(比如同时用
run(order=1)和run(after="test_x")),冲突时行为未定义 - 注意 scope 粒度:
session下所有测试统一排序;function下只在单个 test 文件内生效
替代方案:不用插件,靠 pytest_collection_modifyitems 控制顺序
当项目不能引入第三方插件,或需要更灵活逻辑(比如按标签+时间戳+环境变量动态排序),钩子函数是更底层、更可控的选择。
实操建议:
- 在
conftest.py中实现该钩子,遍历items列表,用items.sort(key=...)重排 - key 函数里可读取
item.name、item.get_closest_marker("critical"),甚至os.getenv("ENV") - 慎用
item.own_markers做排序依据——如果测试没打标记,会抛AttributeError
pytest-ordering 和 pytest-dependency 能否一起用
能,但顺序很重要:依赖关系必须在排序之后解析,否则 depends=["test_a"] 可能找不到已被重排到后面的 test_a。
实操建议:
- 命令行参数顺序要固定:
pytest --order-scope=function --dependency-mode=strict ... - 确保被依赖的测试有明确
@pytest.mark.run(order=N),且N小于依赖方的 order 值 - 遇到
DependencyNotSatisfiedError时,先关掉 ordering 测试是否真缺依赖;再开 sorting 查 order 是否设反了
CI 环境下顺序控制失效的常见诱因
本地跑得好,CI 上乱序,大概率不是代码问题,而是并行或路径差异导致的隐性干扰。
实操建议:
- 禁用 pytest-xdist 并行:
-n 0,否则order-scope=session在多进程下无意义 - 检查 CI 中是否用了
--cache-clear或临时目录,导致 conftest.py 未被加载(钩子失效) - 确认 CI 的 Python 版本和 pytest 版本与本地一致——
pytest-ordering对 pytest 7.0+ 支持不完全向后兼容
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










