在Django跨应用导入模型时遭遇“Apps aren't loaded yet.”错误求助

我来帮你梳理问题所在和针对性的解决办法——你遇到的核心问题是：在Django应用还没完成加载初始化的阶段，就提前尝试导入了模型类，从而触发了AppRegistryNotReady错误。虽然你已经做了不少尝试，但可能是导入时机或者脚本运行方式的细节没处理对，下面给你拆解几个关键思路：

1. 调整模块级导入的时机 #

从你的回溯信息来看，错误出在planning/models.py的第25行——你在模块顶部直接导入了catalog的模型。如果这不是用来定义模型间的外键关联，只是脚本逻辑需要用到catalog的数据，绝对不要在模块级别做这种导入。

正确的做法是把导入放到函数内部，比如你脚本的main()函数里：

# planning/models.py 或你的自定义脚本文件
def main():
    # 等Django初始化完成后再导入模型
    from catalog.models import VarietyData
    # 执行查询逻辑
    data = VarietyData.objects.all()
    # ...其他业务操作

如果你的planning模型确实需要和catalog的模型做外键关联，那应该用字符串引用的方式定义外键，而不是直接导入：

# planning/models.py
from django.db import models

class YourPlanningModel(models.Model):
    # 用"应用名.模型名"的字符串格式引用，避免提前导入
    variety = models.ForeignKey('catalog.VarietyData', on_delete=models.CASCADE)

这种方式会让Django延迟解析模型关联，直到所有应用都加载完成，彻底避免提前导入导致的错误。

2. 用Django官方推荐的方式运行自定义脚本 #

手动写初始化脚本很容易出错，Django本身提供了更可靠的方案：自定义管理命令。这种方式会自动帮你处理Django环境的初始化，不需要自己维护sys.path和django.setup()的逻辑。

步骤如下：

1. 在planning应用下创建目录结构：planning/management/commands，每个目录都要创建空的__init__.py文件。
2. 在commands目录下创建脚本文件，比如run_planning_query.py：

from django.core.management.base import BaseCommand
from catalog.models import VarietyData

class Command(BaseCommand):
    help = "执行planning应用的查询脚本"

    def handle(self, *args, **options):
        # 在这里写你的查询逻辑
        self.stdout.write("开始查询catalog数据...")
        variety_list = VarietyData.objects.all()
        self.stdout.write(self.style.SUCCESS(f"成功获取{len(variety_list)}条数据"))
        # ...其他业务逻辑

3. 运行脚本：在项目根目录执行python manage.py run_planning_query

这种方式完全规避了手动初始化的风险，也是Django官方推荐的自定义脚本运行方式。

3. 修正独立脚本的初始化顺序 #

如果你坚持用独立脚本的方式，一定要确保所有模型导入都在django.setup()之后。正确的脚本结构应该是这样的：

def main():
    # 这里才导入需要的模型
    from catalog.models import VarietyData
    from planning.models import YourPlanningModel
    # 执行具体逻辑
    target_data = VarietyData.objects.filter(status="active")
    # ...其他操作

if __name__ == '__main__':
    import sys, os, django
    project_path = "path/to/your/project"
    if project_path not in sys.path:
        sys.path.insert(0, project_path)
    # 设置Django配置环境变量
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "project_name.settings")
    # 初始化Django环境
    django.setup()
    # 最后调用主函数
    main()

绝对不能在django.setup()之前导入任何应用的模型，否则会直接触发AppRegistry错误。

为什么python manage.py shell能正常工作？ #

因为manage.py shell在启动时已经完成了Django环境的全流程初始化——包括加载所有应用、配置数据库连接、初始化AppRegistry等，所以此时导入模型是完全安全的。

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