Django __init__.py自定义函数触发AppRegistryNotReady错误的原因及修复

Django的应用加载存在严格的执行时序要求：

• 系统启动初期，会第一时间执行INSTALLED_APPS中所有应用的__init__.py顶层代码，这个阶段完全未完成应用注册表（App Registry）的初始化，所有ORM模型都还没有完成注册映射，此时导入任何关联了ORM的模型类（比如django.contrib.auth的User模型）都会直接触发AppRegistryNotReady错误。
• 正常的加载时序是：先执行所有应用的__init__.py代码 → 再加载所有应用的models.py文件、完成全量ORM模型注册 → 标记应用注册表为就绪状态 → 此后才允许正常导入使用所有模型。

你当前的写法在__init__.py中直接导入a.py、b.py的自定义函数，会连带触发这两个模块的顶层导入语句执行。当a.py或b.py的顶层位置写了from django.contrib.auth.models import User时，这段导入代码会在应用初始化的最早期被执行，抢在注册表就绪前完成模型导入，自然就会抛出时序类错误。

完全可以在不改动__init__.py原有导入逻辑、不挪走自定义函数位置的前提下解决这个问题，具体可根据代码结构选择两种实现方式：

• 最简洁的方案：将a.py、b.py顶层位置的User模型导入语句，移动到对应使用该模型的自定义函数内部。
  模块顶层的导入会在模块被引入时立刻执行，而函数内部的导入仅在函数被实际调用时才会执行。等用户真正调用这些自定义函数时，Django早就完成了全应用的初始化流程，此时再导入模型不会出现任何时序冲突。
  修复前后的代码对比如下：
  触发错误的原写法：

  # a.py 顶层位置
  from django.contrib.auth.models import User
  
  def custom1():
      return User.objects.all()
  

  修复后的写法：

  # a.py 顶层不再放置模型导入逻辑
  def custom1():
      # 导入移到函数内部，调用时才执行
      from django.contrib.auth.models import User
      return User.objects.all()
  

• 适配多函数复用场景的方案：如果同一个模块里有多个函数需要使用User模型，不想在每个函数里重复写导入语句，可以在模块顶层做延迟加载，配合Django的初始化完成信号自动加载模型：

  # a.py 顶层
  from django.apps import apps
  from django.core.signals import post_setup
  
  # 模块级变量占位
  User = None
  
  def _load_related_models(**kwargs):
      global User
      # 仅在应用注册表就绪后加载模型
      if apps.ready:
          from django.contrib.auth.models import User as _user
          User = _user
  
  # 绑定Django初始化完成的信号，自动触发模型加载
  post_setup.connect(_load_related_models)
  

注意：不要使用提前调用django.setup()的临时hack规避问题，这种写法会打乱Django原生的加载时序，后续会引发更多隐蔽的应用注册冲突问题。

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