如何处理Django测试过程中非托管模型（managed=False）无数据表的报错问题

问题根源 #

Django 运行测试时默认仅会为managed = True的模型创建测试库表，非托管模型无对应迁移文件，多数据库场景下还会受数据库路由规则限制，导致测试库缺失对应表报错。

可行解决方案 #

方案1：测试运行时临时修改非托管模型的managed属性 #

在项目tests/__init__.py中添加以下逻辑，仅在测试环境下将非托管模型临时改为托管状态：

from django.apps import apps
from django.conf import settings

# 提前在settings.py中添加配置：TESTING = os.environ.get('RUN_TESTS', '0') == '1'
# 运行测试前设置环境变量RUN_TESTS=1即可触发
if settings.TESTING:
    # 遍历所有非托管模型，临时修改managed属性
    for model in apps.get_models():
        if not model._meta.managed:
            model._meta.managed = True

多数据库场景下需要同步调整数据库路由的allow_migrate方法，允许测试环境下非托管模型在对应数据库建表：

# 你的自定义数据库路由类中的allow_migrate方法修改示例
def allow_migrate(self, db, app_label, model_name=None, **hints):
    from django.conf import settings
    if settings.TESTING:
        model = hints.get('model')
        if model and not model._meta.managed:
            # 按你实际的路由规则返回对应数据库是否允许迁移
            return db == self.get_write_db_for_model(model)
    # 原有业务逻辑保持不变
    ...

方案2：为非托管模型生成测试专用迁移文件 #

如果遗留库表结构长期固定，可以单独生成仅在测试环境生效的迁移文件：

1. 临时将目标非托管模型的managed = False改为managed = True
2. 执行python manage.py makemigrations 你的应用名 --name test_legacy_tables生成迁移文件
3. 将模型的managed属性改回False
4. 修改生成的迁移文件，仅测试环境执行建表操作：

from django.conf import settings
from django.db import migrations

if settings.TESTING:
    operations = [
        # 保留自动生成的建表操作
        migrations.CreateModel(...),
    ]
else:
    operations = []

方案3：多数据库测试配置修正 #

sqlite3 多库测试需要在settings.py中明确配置每个数据库的测试库参数：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'default.sqlite3',
        'TEST': {'NAME': BASE_DIR / 'test_default.sqlite3'}
    },
    'legacy_db1': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'legacy1.sqlite3',
        'TEST': {'NAME': BASE_DIR / 'test_legacy1.sqlite3'}
    },
    'legacy_db2': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'legacy2.sqlite3',
        'TEST': {'NAME': BASE_DIR / 'test_legacy2.sqlite3'}
    }
}

运行测试时添加--keepdb参数可以避免每次重建测试库，大幅提升测试效率：

RUN_TESTS=1 python manage.py test --keepdb

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