pytest本身不原生支持Django测试生命周期管理,必须配合pytest-django插件并显式配置DJANGO_SETTINGS_MODULE和--ds参数,否则会报AppRegistryNotReady或静默跳过模型操作;其根本原因是pytest默认不触发Django的app注册、数据库初始化及信号机制。

直接说结论:pytest 本身不原生支持 Django 测试生命周期管理,必须配合 pytest-django 插件,并显式配置 DJANGO_SETTINGS_MODULE 和数据库行为,否则测试会报 django.core.exceptions.AppRegistryNotReady: Apps aren't loaded yet. 或静默跳过模型操作。
为什么 pytest-django 不是“装了就能用”
Pytest 默认不触发 Django 的 setup_databases、teardown_databases 和 app registry 加载流程。仅靠 import django 或手动调用 django.setup() 无法替代完整测试环境初始化——尤其在涉及 models.ForeignKey、信号(post_save)、自定义管理器时会出错。
实操建议:
- 必须在
pytest.ini或pyproject.toml中声明--ds(Django settings)参数,例如:--ds=myproject.settings.test - 禁用 pytest 默认的
python_files = test_*.py匹配规则,改用python_files = *_test.py test_*.py,避免与 Django 原生TestCase混淆 - 不要在测试文件里写
from django.test import TestCase;若需事务回滚语义,用@pytest.mark.django_db(transaction=True)替代继承
pytest.mark.django_db 的三种用法与陷阱
该标记控制数据库是否启用、是否复用、是否清空,直接影响测试速度和隔离性。默认行为是每个测试函数独占一个事务级数据库快照(最快),但有严格限制:
立即学习“Python免费学习笔记(深入)”;
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
- 不加参数(
@pytest.mark.django_db):事务内可见,但commit后数据不可查,且无法测试transaction.atomic()块外的副作用 - 加
transaction=True:绕过事务快照,直接操作真实 DB,适合测试 Celery 任务、信号或跨事务逻辑,但必须手动清理(MyModel.objects.all().delete()) - 加
reset_sequences=True:重置主键自增序列,防止测试间 ID 冲突,但仅对 PostgreSQL/SQLite 生效,MySQL 不支持
常见错误现象:IntegrityError: duplicate key value violates unique constraint —— 多因未设 reset_sequences=True 且测试顺序不稳定导致。
如何写真正可复现的集成测试(含 API + 视图 + 表单)
纯单元测试只验证单个函数或方法,而集成测试需模拟请求-响应链路。Django 的 Client 在 pytest 下仍可用,但要注意三点:
- 必须用
@pytest.mark.django_db标记测试函数,否则client.post()提交的表单数据不会落库 - 避免用
reverse()生成 URL:它依赖 URLconf 加载,而 pytest-django 可能延迟加载;改用硬编码路径(如/api/users/)或提前在 conftest.py 中调用from django.urls import clear_url_caches; clear_url_caches() - 检查响应状态码别只写
assert response.status_code == 201,要加assert response.json()["email"] == "test@example.com"—— 否则可能掩盖序列化器字段名拼写错误等静默失败
示例(验证用户注册视图):
@pytest.mark.django_db
def test_user_registration_creates_active_user(client):
data = {"email": "new@user.com", "password": "secret123"}
response = client.post("/api/register/", data, content_type="application/json")
assert response.status_code == 201
assert User.objects.filter(email="new@user.com", is_active=True).exists()
fixture 重用比继承 TestCase 更灵活,但也更易失控
pytest 的 fixture 是组织测试数据的核心,但 Django 模型 fixture 容易引发隐式耦合:
- 用
@pytest.fixture创建模型实例时,别在 fixture 内部调用save()—— 应返回未保存对象,由测试函数决定何时落库,便于组合不同状态 - 避免跨 fixture 依赖数据库操作(如 A fixture 创建 User,B fixture 用该 User 创建 Profile):这会让测试顺序敏感,应改用工厂模式(
factory_boy)或参数化 fixture - 慎用
autouse=True的数据库 fixture:它会在每个测试前无差别重建全部测试数据,拖慢执行,且掩盖“某个测试意外修改了共享状态”的问题
复杂点在于:Django 的 TransactionTestCase 级别行为(如测试数据库迁移、全文检索)无法被 pytest-django 完全覆盖,此时仍需保留少量原生 TestCase 子类测试文件。

















