AppRegistryNotReady 是 Django 应用注册未完成时访问模型引发的异常，主因是在 django.setup() 完成前于模块顶层执行了模型类访问、get_model()、ForeignKey(模型类) 等操作，常见于 settings.py、urls.py、apps.py 或 models.py 的导入链中过早触发 ORM。
AppRegistryNotReady 是什么，为什么在 Django 启动时突然报这个错
AppRegistryNotReady 不是代码写错了，而是 Django 的应用注册机制被提前触发了。典型现象是：你在 models.py、apps.py 或模块顶层（比如 <strong>init</strong>.py）里直接调用了 get_model()、auth.get_user_model()，或者访问了某个模型的 _meta、objects 等属性 —— 这些操作都隐式依赖已加载的模型 registry，但此时 Django 还没完成 apps 初始化。
常见触发点包括：
- 在
settings.py里 import 某个 models 模块 - 在
urls.py顶层 import 视图时，视图文件又提前 import 了 model - 自定义
AppConfig.ready()里调用了未加保护的模型操作
怎么定位具体哪一行触发了 AppRegistryNotReady
错误堆栈通常只显示 “AppRegistryNotReady: Apps aren't loaded yet”，不指明位置。要快速定位：
- 启动时加
--traceback参数：python manage.py runserver --traceback - 在
manage.py开头临时插入调试钩子：import django print("Django version:", django.get_version()) print("Apps ready?", django.apps.apps.ready) - 检查所有
import链：从manage.py → settings → urls → views → models，逐层确认有没有在模块级执行模型访问
关键原则：任何对模型类本身的使用（非字符串引用），都必须发生在 django.setup() 之后，或封装在函数/方法内延迟执行。
立即学习“Python免费学习笔记（深入）”；
models.py 和 apps.py 里哪些写法会踩坑
models.py 里看似安全的操作，其实可能越界：
- 使用
ForeignKey('auth.User')是 OK 的（字符串引用，惰性解析） - 但写成
ForeignKey(User)（直接导入User类）就危险，除非确保User所在 app 已加载且 import 发生在ready()之后
apps.py 中的常见误用：
- 在
ready()外部定义变量并访问模型：DEFAULT_CATEGORY = Category.objects.get_or_create(...)❌ - 在
ready()内部直接调用get_model('myapp.MyModel')而没加 try/except 或检查apps.ready❌（虽然ready()被调用时通常已就绪，但某些第三方包或测试环境仍可能不稳）
正确做法：
- 把模型访问逻辑包裹进函数，例如
def get_default_category(): return Category.objects.get_or_create(...) - 如必须预热数据，在
ready()中用django.apps.apps.ready双重校验 - 避免在
apps.py顶层 import 模型模块（尤其是跨 app）
如何安全地在 settings.py 或全局模块中引用模型
settings.py 是最常出问题的地方，因为它在 Django 初始化早期就被读取。以下写法都不行：
from myapp.models import MyModelMY_MODEL = get_model('myapp.MyModel')
替代方案只有两个：
- 用字符串代替模型类：
AUTH_USER_MODEL = 'auth.User'（Django 原生支持） - 把模型相关逻辑推迟到运行时：比如把配置项设为字符串，首次使用时再通过
apps.get_model()解析，并缓存结果
如果非要在 settings 里动态决定模型，可以这样封装：
def get_my_model():
from django.apps import apps
return apps.get_model('myapp.MyModel')
然后在视图或管理命令里调用它，而不是在模块顶层执行。
真正容易被忽略的是：哪怕你没显式 import 模型，某些日志配置、中间件初始化、甚至自定义装饰器的定义过程，也可能触发模型反射 —— 所有这些都要放在函数体内，而不是模块作用域。
