pytest-django默认为每个测试函数开启事务并自动回滚,手动truncate会破坏隔离性、引发数据污染或测试失败;99%场景应使用django_db fixture、factory_boy或model.objects.all().delete()等安全方式准备数据。

不需要在 pytest 中手动 TRUNCATE TABLE —— 这是常见误解,也是容易引发数据污染或测试失败的高危操作。
pytest-django 自带事务隔离,手动 TRUNCATE 会破坏它
pytest-django 默认为每个测试函数开启一个数据库事务,并在测试结束时自动 ROLLBACK。这意味着:所有 Model.objects.create()、save()、bulk_create() 等写入操作,只在当前测试生命周期内可见,不会留下任何脏数据。
- 你写
user = User.objects.create(username="test")→ 数据进 DB → 测试结束 → 自动回滚 → 下一个测试看到的是空表 - 如果你在测试里手动执行
TRUNCATE TABLE auth_user,就绕过了事务机制,直接清空真实表结构,可能影响其他并行测试(尤其用--workers时) - 更严重的是:
TRUNCATE不可回滚,一旦执行失败(比如外键约束),整个测试进程可能卡死或状态异常
什么情况下真要 TRUNCATE?只有两类明确场景
极少数情况需要主动清空,但必须严格满足条件:
-
测试前重置全局状态表:比如日志表
audit_log、统计缓存表daily_summary,这些表不参与事务(例如用了atomic=False或直连非事务引擎),且你确认所有测试都不依赖其历史数据 -
性能敏感的大型测试集启动前:当单次运行包含数百个测试、且每个都创建大量数据导致事务日志膨胀时,可在
conftest.py的 session 级 fixture 中用TRUNCATE清理,但必须加锁 + 显式关闭事务:transaction.set_autocommit(False),否则报错 - 注意:
TRUNCATE在 SQLite 中不支持外键约束,在 MySQL 中需ALTER权限,在 PostgreSQL 中等价于TRUNCATE ... CASCADE,行为不一致
替代方案:用 pytest-django 的 fixture 和 factory 更安全
99% 的数据库回归测试,应该用以下方式准备数据,而非清空:
- 用
django_dbfixture 声明测试需要数据库,pytest-django 自动接管事务 - 用
factory_boy或model_bakery创建按需实例,比如:UserFactory(username="alice", email="a@example.com") - 对需要“干净起点”的测试,直接在 setup 阶段调用
Model.objects.all().delete()—— 它走 ORM、可回滚、兼容所有后端,比TRUNCATE安全得多 - 避免跨测试共享数据;每个测试应独立构造自己所需的数据,而不是靠“清空旧数据”来复位
真正容易被忽略的点是:TRUNCATE 看似快,实则把测试从“隔离单元”拉回“共享环境”,一旦漏掉权限检查、引擎适配或并发控制,CI 就会间歇性失败。而 pytest-django 的事务模型,才是回归测试稳定性的底层保障。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











