Django PDF测试异常：单测试通过但全量测试套件执行失败

问题描述 #

我有一个用Reportlab生成各类PDF的Django应用，PDF功能正常，但测试时出现异常。测试代码如下：

response = self.client.get(pdf_url)
reader = PdfReader(BytesIO(response.content))
text = ''
for page in reader.pages:
    text += page.extract_text()

self.assertTrue("Apples" in text)

其中一个测试用例在全量测试套件运行时失败，报错：

self.assertTrue("Apples" in text)
AssertionError: False is not true

奇怪的现象：

• 单独运行该测试用例或单个TestCase时全部通过
• 反向执行测试会出现2个失败用例
• 确认传入Reportlab的内容包含"Apples"，PdfReader能提取其他内容，但就是提取不到这个字符串

可能的原因及解决思路 #

• 测试环境状态污染：全量测试时，前置测试用例可能修改了全局状态（数据库数据、缓存、Reportlab全局配置），导致PDF生成上下文和单测时不一致。解决：在每个测试的setUp()/tearDown()中重置状态，比如回滚数据库事务、清空缓存、重置Reportlab的字体/模板配置。
• Reportlab资源加载异常：全量测试时字体或资源未正确加载，导致"Apples"被渲染成无法识别的占位符。解决：在setUp()中显式注册所需字体，确保测试环境和生产环境字体配置一致，检查字体文件是否存在。
• 响应内容不完整：Django测试客户端在全量测试时可能存在缓存，或PDF生成的异步操作未完成就返回响应，导致获取的PDF内容缺失。解决：测试时禁用客户端缓存，确保PDF生成为同步操作；获取响应后先验证response.status_code == 200，并检查内容大小是否符合预期。
• PyPDF2提取特性差异：全量测试生成的PDF结构和单测时略有不同，PyPDF2默认提取方式无法识别目标文本。解决：尝试使用page.extract_text(extraction_mode="layout")优化提取；或查看PDF内部结构，确认"Apples"是否被正确写入。
• 测试用例隐式依赖：测试用例之间存在数据依赖，前置测试修改了PDF生成所需数据，导致后续测试生成的PDF内容不符。解决：确保每个测试用例独立，利用django.test.TestCase的自动事务回滚特性，在setUp()中创建独立测试数据。

内容的提问来源于stack exchange，提问作者Morgan SP