必须继承 django.test.TestCase 才能启用事务隔离、测试数据库和 fixture 加载;测试方法名须以 test_ 开头;Client 测试前需确认路由配置、命名空间及登录态;优先用 setUpTestData 预置数据,避免 setUp 重复创建;ModelForm 测试需确保 data 传入、字段完整、不绕过验证。

TestCase类怎么写才能真正跑通Django测试
直接继承 django.test.TestCase,别用 unittest.TestCase —— 后者不触发Django的数据库事务隔离和测试数据库创建,跑起来看似成功,实际数据没清空、fixture不加载、ORM操作全失效。
常见错误现象:DoesNotExist 报错但手动查数据库明明有数据;assertEqual(qs.count(), 1) 总是为0;测试之间互相污染,第二条测试莫名失败。
- 必须从
django.test.TestCase(或其子类如TransactionTestCase)继承 - 每个测试方法名必须以
test_开头,否则自动被跳过 - 测试运行时,Django会自动创建一个全新的 SQLite(或你配的测试DB),并为每个测试方法包裹在事务里回滚——所以不用手动清理数据
- 如果测试涉及多线程、信号、或需要真实提交事务(比如测试数据库触发器),才考虑换用
TransactionTestCase,但它慢得多
Client模拟请求时URL总404?路由和命名空间别漏配
django.test.Client 不走真实HTTP栈,它直接调用Django视图函数,所以404几乎全是路由配置问题,不是网络或服务问题。
典型场景:本地开发能打开 /api/users/,但测试里 c.get('/api/users/') 返回404。
- 确认测试用的
ROOT_URLCONF是你项目的主urls.py,不是某个app单独的;检查settings.TEST是否意外覆盖了它 - 如果URL带命名空间(比如
path('api/', include('api.urls', namespace='api'))),用c.get('/api/users/')没问题,但用reverse('api:user-list')前必须确保urls.py正确声明了app_name = 'api' -
Client默认不带登录态,访问@login_required视图会重定向到/accounts/login/,导致断言失败;用c.force_login(user)代替手动POST登录 - POST JSON接口时,记得加
content_type='application/json',否则Django当表单处理,request.body解析为空
测试数据库里没数据?fixture和setUpTestData别混用
想预置测试数据,setUpTestData 是首选,比 setUp 快5–10倍;但很多人误以为 fixture 文件(fixtures = ['users.json'])更“正规”,结果发现数据根本没进库。
错误现象:fixture文件存在、路径正确、格式合法,但 User.objects.count() 还是0;或者 fixture 里的外键ID和测试代码生成的对象对不上,引发 IntegrityError。
-
fixtures列表只在类级别加载一次,在setUpTestData之前;它依赖模型字段名和JSON字段严格匹配,且默认按模型定义顺序加载——如果有外键依赖,顺序错就失败 -
setUpTestData(cls)是类方法,在整个测试类所有方法前执行一次,适合创建共享的、不可变的测试对象(比如管理员用户、常用分类) - 避免在
setUp里重复创建大量对象,尤其带外键或M2M的,会显著拖慢测试速度 - 用
cls.user = User.objects.create_user(...)创建对象后,记得显式保存(.save())或用create_user这类封装好的方法
为什么测试里ModelForm.save()不报错但数据没入库
Django测试中,ModelForm 的验证和保存逻辑完全正常,但如果你看到 form.is_valid() is True 且调用了 form.save(),却查不到数据,大概率是忘了 commit 或事务干扰。
关键点:测试环境下 TestCase 的事务机制,会让 save() 看似成功,但后续查询可能因缓存或事务隔离看不到刚写的行——不过这通常不是主因;更常见的是 form 字段没传全或 cleaned_data 被意外覆盖。
- 检查 form 初始化是否传了
data=...和files=...(上传文件时必填),空字典{}和None行为不同 - 确认 model 字段没有
default=...或auto_now_add=True导致你以为写了字段,其实被覆盖了;打印form.cleaned_data看实际进了什么 - 不要在测试里直接改
form.instance.xxx = yyy后再save(),优先用form.save(commit=False)+ 修改 +.save() - 如果 model 有自定义
save()方法,里面调了外部API或发信号,测试时得用@override_settings关掉,否则可能超时或报错
测试最难绷的点其实是“以为自己在测逻辑”,结果卡在路由拼错、fixture加载失败、或 Client 没 force_login 这种低层链路上——跑不通先看 URL 和用户态,再查数据有没有真落地。










