pytest fixture 实战:作用域、依赖注入与数据库清理的四种错法

举报
yd_257742204 发表于 2026/11/17 06:04:35 2026/11/17
【摘要】 从 scope 选错导致连接池被打爆、用 setup/teardown 顺序代替依赖关系、autouse 滥用把依赖藏起来、teardown 抛异常掩盖真实失败四个角度拆解 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 不是省代码的工具,是描述"这个测试需要什么环境"的语法。把环境写成依赖,测试才会既快又能读。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。