如何在Django中用unittest测试时避免ORM导入触发的AppRegistryNotReady错误？

针对你遇到的问题——用原生unittest.TestCase测试时，只要导入含Django模型的模块（哪怕只是mock）就触发AppRegistryNotReady错误，同时不想重构逻辑层或强制用接口式依赖注入，这里提供几种实用的替代方案：

1. 手动轻量初始化Django，不启动完整测试环境 #

不需要像django.test.TestCase那样创建测试数据库、执行迁移，只初始化Django的AppRegistry，就能安全导入模型，同时保持测试速度接近原生unittest。

在测试文件的最顶部添加以下代码：

import django
from django.conf import settings

if not settings.configured:
    # 仅配置必要的核心组件和你的业务APP
    settings.configure(
        DEBUG=True,
        SECRET_KEY='test-only-secret',
        INSTALLED_APPS=[
            'django.contrib.contenttypes',  # 模型加载必需的核心APP
            'django.contrib.auth',          # 如果用到用户模型等需要
            'your_business_app',            # 你的业务应用名称
        ],
        DATABASES={
            'default': {
                'ENGINE': 'django.db.backends.sqlite3',
                'NAME': ':memory:',         # 用内存数据库，避免磁盘IO
            }
        }
    )
    django.setup()

这种方式只会加载Django最基础的核心模块，不会执行数据库迁移或创建测试表，速度远快于Django自带的测试用例，同时解决了模型导入的报错问题。

2. 用mock.patch延迟/替换模型导入 #

不要在测试文件顶部直接导入依赖模型的业务模块，而是通过mock.patch在测试方法内部或导入前替换掉模型引用，避免实际加载Django模型。

举个例子，原来的测试代码会直接导入依赖模型的服务：

from unittest import TestCase
from my_app.services import UserService  # 该模块内部导入了User模型

class TestUserService(TestCase):
    def test_user_creation(self):
        # ... 测试逻辑

改成先mock模型再导入服务：

from unittest import TestCase, mock

# 在导入服务前mock掉模型引用，避免触发Django加载
with mock.patch('my_app.services.User'):
    from my_app.services import UserService

class TestUserService(TestCase):
    def test_user_creation(self):
        # 测试时可以进一步定制mock行为
        mock_user = mock.Mock()
        mock_user.save.return_value = None
        service = UserService()
        # ... 测试逻辑

如果只是单个测试方法需要用到服务，也可以在方法内导入：

from unittest import TestCase, mock

class TestUserService(TestCase):
    @mock.patch('my_app.services.User')
    def test_user_creation(self, mock_user_cls):
        from my_app.services import UserService
        service = UserService()
        # ... 测试逻辑

3. 轻量改造业务类，延迟模型导入（无需接口） #

不用为每个类创建接口，只需要稍微调整业务类的依赖方式，延迟模型的导入时机，同时支持测试时传入mock对象。

比如原来的业务类直接导入模型：

# my_app/services.py
from .models import User

class UserService:
    def get_user(self, user_id):
        return User.objects.get(id=user_id)

改成通过初始化参数注入模型，默认延迟导入：

# my_app/services.py
class UserService:
    def __init__(self, user_model=None):
        self.user_model = user_model or self._get_default_model()
    
    def _get_default_model(self):
        # 延迟导入模型，只有实际调用业务方法时才会触发
        from .models import User
        return User
    
    def get_user(self, user_id):
        return self.user_model.objects.get(id=user_id)

测试时直接传入mock的模型类，完全不需要加载Django：

from unittest import TestCase, mock

class TestUserService(TestCase):
    def test_get_user(self):
        mock_user = mock.Mock(id=1)
        mock_user_cls = mock.Mock()
        mock_user_cls.objects.get.return_value = mock_user
        
        service = UserService(user_model=mock_user_cls)
        result = service.get_user(1)
        
        self.assertEqual(result.id, 1)
        mock_user_cls.objects.get.assert_called_once_with(id=1)

4. 切换到pytest+ pytest-django（如果团队允许） #

如果团队能接受用pytest替代原生unittest，pytest-django插件可以完美解决这个问题：它会自动管理Django的初始化，只有标记了django_db的测试才会加载完整的数据库环境，其他测试会以原生速度运行，且不会触发AppRegistry错误。

示例代码：

# 无需ORM的测试，快速运行
def test_user_service_validation():
    from my_app.services import UserService
    service = UserService()
    assert service.validate_username("valid_user") is True

# 需要ORM的测试，自动初始化Django环境
import pytest
from my_app.models import User

@pytest.mark.django_db
def test_user_creation_in_db():
    user = User.objects.create(username="test_user")
    assert User.objects.count() == 1

运行测试时，未标记的测试会直接以原生unittest速度执行，标记的测试才会加载Django环境，整体测试效率会大幅提升。

内容的提问来源于stack exchange，提问作者Antonio Gamiz Delgado