Django文件上传模型按顺序执行测试失败问题排查

针对你遇到的测试用例单独执行正常、按顺序执行断言失败且失败用例会随测试顺序变化的问题，核心原因是测试用例之间未完全隔离媒体文件存储或数据库状态，以下是具体排查方向和解决方法：

1. 媒体存储未做测试级隔离 #

Django默认测试环境会用内存处理文件上传，但如果你的自定义存储类直接操作本地文件系统，测试用例之间会共享同一个MEDIA_ROOT，导致前一个测试的文件残留影响后续测试。

• 解决方法：每个测试用例使用独立的临时媒体目录，通过setUp/tearDown动态替换MEDIA_ROOT：

  from django.test import TestCase
  import tempfile
  
  class FileUploadTest(TestCase):
      def setUp(self):
          # 创建临时目录作为测试媒体根目录
          self.temp_media_dir = tempfile.TemporaryDirectory()
          self.settings(MEDIA_ROOT=self.temp_media_dir.name)
  
      def tearDown(self):
          # 销毁临时目录，自动清理所有文件
          self.temp_media_dir.cleanup()
  

2. 异步任务/信号未同步执行 #

如果文件删除、目录清理依赖Celery异步任务或Django信号，测试时异步任务可能未执行完成，或者信号未被正确触发，导致文件残留。

• 解决方法：
  • 测试时强制Celery任务同步执行，避免异步延迟：

    from django.test import override_settings
    
    @override_settings(CELERY_TASK_ALWAYS_EAGER=True)
    def test_file_update_deletes_old_file(self):
        # 测试逻辑
        pass
    

  • 检查模型save/delete方法中信号触发逻辑，确保在测试环境下能正常执行，比如避免仅在生产环境启用信号。

3. 数据库事务未正确回滚 #

如果使用TransactionTestCase而非TestCase，测试用例结束后不会自动回滚数据库事务，残留的数据库记录会触发错误的文件操作逻辑。

• 解决方法：
  • 优先使用django.test.TestCase作为测试基类，它会自动为每个测试用例创建独立事务，执行完成后回滚。
  • 若必须使用TransactionTestCase，需在tearDown中手动删除所有测试创建的模型实例，并调用对应的文件清理逻辑。

4. 自定义存储类存在全局状态 #

如果你的自定义存储类使用了全局变量或缓存（比如缓存已存在的目录列表），测试用例之间会共享这些状态，导致文件操作逻辑判断错误。

• 解决方法：
  • 检查存储类代码，移除全局状态，改为实例级状态。
  • 在测试setUp中重置存储类的缓存，比如调用存储类的重置方法：

    def setUp(self):
        # 重置自定义存储类的缓存
        from myapp.storage import CustomStorage
        CustomStorage.clear_cache()
    

5. 文件系统操作的竞态条件 #

测试中文件创建/删除的IO操作可能存在延迟，导致断言时文件状态还未更新，出现偶发失败。

• 解决方法：
  • 使用存储类的exists方法替代直接调用os.path.exists，确保使用Django存储的逻辑判断文件状态：

    from django.core.files.storage import default_storage
    
    def test_file_deleted_after_instance_delete(self):
        instance = FileUploadModel.objects.create(file=test_file)
        file_path = instance.file.path
        instance.delete()
        # 验证文件是否被删除
        self.assertFalse(default_storage.exists(file_path))
    

  • 必要时加入短暂等待（比如time.sleep(0.1)），但尽量避免，优先确保操作同步执行。

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