pytest fixture 实战:作用域、依赖注入与数据库清理的四种错法
pytest fixture 实战:作用域、依赖注入与数据库清理的四种错法
写测试写到一定规模,真正拖慢你的往往不是断言写不出来,而是 fixture 用得别扭:测试之间互相污染、数据库连接被打爆、一个 fixture 拖垮整轮耗时。下面这些问题我都踩过,按"错在哪—为什么—怎么改"整理一遍。
一、scope 选错:function 级 fixture 里建连接池
最常见的写法是这样:
@pytest.fixture
def db():
conn = create_engine(DB_URL)
yield conn
conn.dispose()
单测跑十个用例没问题,跑三百个就开始报 too many connections,整轮耗时也从 20 秒涨到 6 分钟。
原因是 function 是默认作用域,每个测试函数都会重建一次引擎。改法是把建连拆出来:
@pytest.fixture(scope="session")
def engine():
e = create_engine(DB_URL, pool_size=5)
yield e
e.dispose()
@pytest.fixture
def db(engine):
conn = engine.connect()
tx = conn.begin()
yield conn
tx.rollback()
conn.close()
session 级只建一次池,function 级只借一个连接并在事务里回滚。作用是既隔离又不用反复建池。判断标准很简单:创建成本高、无状态 → 放大 scope;有状态、需要还原 → 留在 function。
二、用 setup/teardown 顺序代替依赖关系
有人喜欢在一个 fixture 里做完所有事:
@pytest.fixture
def prepared(db, tmp_path):
run_migrations(db)
seed_data(db)
(tmp_path / "config.yml").write_text("debug: true")
yield
db.execute("TRUNCATE users")
这种"大 fixture"有三个后果:任何一处失败,报错都指向同一个 fixture,定位成本高;只想用 seed 数据的测试也被迫跑迁移;teardown 里 TRUNCATE 一旦异常,整轮后续全部失败。
fixture 的正确用法是表达依赖,不是表达流程。拆成 migrated → seeded → with_config 三层,让 pytest 帮你按需组合,哪层坏了一眼看得出来。
三、autouse 滥用:隐式依赖让测试不可读
autouse=True 很方便,但它把依赖藏起来了。半年后有人加一个不碰数据库的纯函数测试,却被 autouse 的 db fixture 拖去连库,跑得慢还不知道为什么。
经验规则:autouse 只用于两类东西——清理临时目录、重置全局单例这类"无论谁都该做"的动作。业务数据的准备一律显式写进参数列表。
四、teardown 抛异常掩盖真实失败
yield
db.execute("DELETE FROM orders") # 这里报错
如果主测试断言失败、teardown 又抛错,pytest 报的是 teardown 的错误,真正的断言失败被挤到后面,看日志时容易误判。
包一层 try/finally,或者干脆把清理放到事务回滚里做——回滚天然幂等,也不会因为约束冲突失败:
@pytest.fixture
def session(engine):
conn = engine.connect()
tx = conn.begin()
s = Session(bind=conn)
yield s
s.close()
tx.rollback()
conn.close()
一个可以直接抄的骨架
@pytest.fixture(scope="session")
def engine(): ...
@pytest.fixture
def session(engine): ...
@pytest.fixture
def user(session):
u = User(email="t@example.com")
session.add(u); session.flush()
return u
@pytest.fixture(autouse=True)
def _clean_tmp(tmp_path, monkeypatch):
monkeypatch.chdir(tmp_path)
yield
配套的三条自检:①pytest --collect-only -q 看有没有用例被 fixture 拖到不该连库的分组;②单独跑一个用例和跑全量,耗时差不应超过一个数量级;③故意让 teardown 报错,确认主断言失败仍然可见。
fixture 不是省代码的工具,是描述"这个测试需要什么环境"的语法。把环境写成依赖,测试才会既快又能读。
- 点赞
- 收藏
- 关注作者
评论(0)