从Django 1.6升级至1.11遇AppRegistryNotReady异常求助

这个异常在Django跨大版本升级时特别常见，尤其是涉及动态自定义模型的场景——因为Django 1.7引入了AppRegistry机制，严格管控了模型的加载顺序和初始化时机，而1.6及之前版本没有这种限制，导致原来在模块级别就能执行的自定义模型逻辑，现在会在AppRegistry就绪前触发模型访问，从而抛出错误。

针对你的自定义模型机制（CustomModel/CustomField配合RootEntityModel的动态配置），可以按以下步骤排查解决：

1. 将自定义模型逻辑移至AppConfig的ready()方法 #

Django的AppConfig.ready()方法是官方推荐的、在AppRegistry完全初始化后执行代码的钩子。你需要把动态创建字段/模型的逻辑放到这里，而非模块加载阶段执行。

步骤示例： #

• 在customization应用下创建apps.py：

from django.apps import AppConfig

class CustomizationConfig(AppConfig):
    name = 'customization'

    def ready(self):
        # 导入并执行自定义模型配置逻辑
        from .models import setup_custom_model_fields
        setup_custom_model_fields()

• 在customization/__init__.py中指定默认AppConfig：

default_app_config = 'customization.apps.CustomizationConfig'

• 把原来在模块级别（比如entities/models.py或customization/models.py）执行的动态字段添加逻辑，封装成setup_custom_model_fields()函数，放在customization/models.py中：

from django.apps import apps

def setup_custom_model_fields():
    # 延迟获取模型，避免提前触发AppRegistry检查
    RootEntityModel = apps.get_model('entities', 'RootEntityModel')
    CustomField = apps.get_model('customization', 'CustomField')

    # 遍历自定义字段，动态添加到RootEntityModel
    for custom_field in CustomField.objects.all():
        # 替换成你实际的字段创建逻辑
        new_field = models.CharField(max_length=255, verbose_name=custom_field.label)
        RootEntityModel.add_to_class(custom_field.field_name, new_field)

2. 避免模块级别的模型访问/查询 #

在Django 1.7+中，模块加载阶段（比如直接在models.py里写CustomField.objects.all()）会触发AppRegistry检查，但此时注册表还未完全初始化，必然抛出AppRegistryNotReady。

• 替换直接导入模型的方式，改用apps.get_model(app_label, model_name)延迟获取模型
• 所有需要访问数据库或模型元数据的逻辑，都要放到ready()方法、信号处理器（如post_migrate）或运行时函数中，不要在模块级别执行

3. 检查循环导入问题 #

如果customization.models和entities.models之间存在循环导入（比如互相导入对方的模型），会打乱AppRegistry的加载顺序，触发异常。

解决方法：

• 移除直接的循环导入，改用apps.get_model()延迟获取
• 将共享逻辑抽离到独立的工具模块，避免模型模块之间的直接依赖

4. 验证迁移与AppRegistry状态 #

如果你的自定义模型涉及动态生成的迁移，确保迁移文件是在AppRegistry就绪后生成的。可以尝试：

• 先运行python manage.py makemigrations生成基础迁移
• 再执行python manage.py migrate确保数据库状态同步
• 最后启动服务，验证自定义模型逻辑是否正常执行

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