pytest session fixture 中不应直接共享数据库连接,而应仅初始化连接池和schema;各测试函数需通过begin_nested()获取独立事务并回滚,确保数据隔离。

pytest session fixture 里不能直接用数据库连接
session 级 fixture 生命周期太长,数据库连接在测试中途可能失效或被其他测试污染。常见错误是写成 yield connection,结果后面测试读到脏数据或报 OperationalError: server closed the connection unexpectedly。
正确做法是只在 fixture 中建连接池、初始化 schema,每次测试单独获取新连接:
- 用
sqlalchemy.create_engine(pool_pre_ping=True)避免复用失效连接 - 在 session fixture 里执行
Base.metadata.create_all(),但不 commit 任何测试数据 - 每个测试函数内通过
session.begin_nested()或临时事务隔离
用 begin_nested() 实现单测级回滚最轻量
不用清库、不重置表、不重建 schema,靠数据库 savepoint 就能干净退出。前提是数据库支持(PostgreSQL/SQLite OK,MySQL 默认不支持 SAVEPOINT)。
典型结构:
立即学习“Python免费学习笔记(深入)”;
@pytest.fixture(scope="function")
def db_session(db_engine):
connection = db_engine.connect()
trans = connection.begin_nested()
session = Session(bind=connection)
yield session
session.close()
trans.rollback() # 回滚到 savepoint,不影响外层
connection.close()注意点:
-
begin_nested()必须在connection上调,不是session - 如果测试里手动
commit(),savepoint 失效,得换TRUNCATE方案 - SQLAlchemy 2.0+ 要用
session.begin_nested()替代老写法
测试间共享 fixture 数据?先确认是不是真需要
session 级 fixture 里塞测试数据,看似省事,实则埋雷:A 测试改了共享数据,B 测试就挂;CI 并行跑时更不可控。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
真要共享(比如预置字典表),必须满足:
- 数据只读,且用
INSERT ... ON CONFLICT DO NOTHING或类似幂等写法 - 写入动作放在 session fixture 的
setup阶段,不在yield后 - 避免依赖顺序——pytest 不保证 session fixture 内多个
yield的执行次序
绝大多数情况,用 function 级 fixture + factory_boy 或 pytest-lazy-fixture 拉取预设数据更稳。
SQLite 内存数据库不适合 session 级隔离
很多人图省事用 sqlite:///:memory:,但 session 级下所有测试共用一个内存实例,根本没隔离。现象是:前一个测试插入的记录,后一个测试能查到。
解决办法只有两个:
- 改用文件数据库路径,如
sqlite:///test_{}.db动态生成(注意清理) - 坚持用内存库,但降级为 function scope,并加
connect_args={"check_same_thread": False}
后者性能好,但别在 CI 里跑并行测试——多进程会抢同一个内存 DB。
session 级 fixture 的真正价值是“一次性初始化开销大的东西”,比如启动 mock 服务、加载大配置、建空库结构。一旦涉及数据写入,边界就得划清楚:谁建、谁用、谁清,漏掉任一环,隔离就失效。

















