fixture重复执行是正常行为,由scope(如默认function级每次测试新建)、参数化(每组参数触发一次)及多进程(xdist下各worker独立session)共同决定。

fixture 重复执行不是 bug,而是作用域(scope)和调用方式共同决定的正常行为。 默认 scope="function" 就意味着每次测试函数都会新建一次 fixture —— 这是设计使然,不是配置错了。
为什么 scope=function 的 fixture 每次都执行
这是 pytest 的默认生命周期:每个测试函数独立运行,彼此隔离。为保证测试纯净性,pytest 在进入每个测试前调用 fixture 的 setup(如创建对象、连接数据库),在测试结束后执行 teardown(如关闭连接、清理临时文件)。
- 如果你看到
print("setup")在每个测试里都输出,说明它确实是function级别 - 即使同一个测试函数内多次请求该 fixture(比如参数化 + fixture 依赖),pytest 也只执行一次 setup,但整个 fixture 实例仍绑定到该测试函数生命周期
- 常见误判点:把「测试函数内多次引用」当成「重复执行」——实际只是缓存复用,不是重新初始化
参数化(parametrize)会让 fixture 执行次数翻倍
当 fixture 被 @pytest.mark.parametrize 装饰的测试函数使用时,pytest 会为每组参数生成一个独立测试用例实例,每个实例都触发一次 fixture 的完整生命周期。
- 例如:
@pytest.mark.parametrize("x", [1,2,3])+def test_foo(db_conn)→db_conn会被初始化 3 次 - 如果
db_conn是function级别,这完全合理;但如果是module级别,却仍被调用多次,说明它被多个参数化测试跨模块/跨类引用了,或作用域被意外覆盖 - 更隐蔽的情况:fixture 自身用了
params=...参数化,那它的执行次数 = 所有依赖它的测试用例数 × 它自己的参数个数
多进程(pytest-xdist)下 session 级 fixture 也会“重复”
很多人以为 scope="session" 就绝对只运行一次 —— 在单进程下成立,但在 pytest-xdist 多进程模式下,每个 worker 进程都有自己的 session,所以 login、token 类 fixture 会被每个进程各执行一次。
- 典型现象:日志里看到 3 个不同 token 值,而你期望全局唯一
- 这不是作用域失效,是进程隔离的必然结果;
session对应的是“每个进程的 session”,不是“整个 pytest 运行的 session” - 若需真正全局共享(如预生成密钥),得靠外部协调机制:文件锁(
filelock)、Redis、或主进程预生成后通过环境变量/临时文件分发
容易被忽略的关键点
fixture 是否“重复”,必须结合三个维度判断:作用域(scope)、是否被参数化驱动、是否运行在多进程环境。单独看某一行 @pytest.fixture 声明,根本无法确定它会被执行几次 —— 它的执行频次由所有下游测试的组织方式动态决定。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











