本文详解 django 项目中跨应用引用模型时如何安全规避循环导入（circular import）与 appregistrynotready 错误，推荐使用字符串引用和函数内导入两种标准方案。
本文详解 django 项目中跨应用引用模型时如何安全规避循环导入（circular import）与 appregistrynotready 错误，推荐使用字符串引用和函数内导入两种标准方案。
在 Django 多应用架构中，常需在一个应用的模型、视图或逻辑中引用另一个应用的模型——例如 shop 应用中的商品需关联 orders.Order。若直接使用 from orders.models import Order，极易引发 循环导入（如 orders/models.py 又反向导入 shop/models.py）；而改用 django.apps.get_model() 动态获取模型，则可能触发 AppRegistryNotReady: Models aren't loaded yet. 错误——这是因为 Django 的模型注册机制要求所有应用的 models.py 必须在 apps.populate() 完成后才能被安全访问，而模块顶层代码（module-level code）执行时该过程尚未完成。
✅ 正确解法取决于具体使用场景，无需手动延迟加载或绕过 Django 初始化：
✅ 场景一：仅在函数/方法内部使用模型（如业务逻辑、数据处理）
将模型导入移至函数体内，确保仅在运行时、模型已就绪后才导入：
# ✅ 正确：延迟导入，避开模块加载期
def calculate_order_summary(product_id):
from orders.models import Order # 在函数内导入
return Order.objects.filter(items__product_id=product_id).count()⚠️ 注意：此方式不适用于模型字段定义（如 ForeignKey），仅适用于运行时逻辑。
✅ 场景二：在模型字段中建立跨应用关系（最常见需求）
Django 原生支持字符串形式的模型引用，完全避免导入依赖：
# shop/models.py
from django.db import models
class Product(models.Model):
name = models.CharField(max_length=100)
# ✅ 正确：使用 'app_label.ModelName' 字符串，Django 自动解析
last_ordered_by = models.ForeignKey(
'orders.Order', # 替代 from orders.models import Order
on_delete=models.SET_NULL,
null=True,
blank=True,
related_name='products_last_ordered'
)
# 同样适用于 ManyToManyField 和 OneToOneField
featured_in = models.ManyToManyField(
'orders.OrderItem',
blank=True
)? 提示：字符串格式统一为
'app_label.ModelName'（如'orders.Order'），大小写敏感，且必须是已注册的已安装应用（即在INSTALLED_APPS中）。
❌ 不推荐的错误尝试
- 在模块顶层调用
apps.get_model()→ 触发AppRegistryNotReady（如问题中所示）； - 使用
import orders然后orders.models.Order→ 仍可能引发循环导入； - 将
django.setup()手动调用以“提前初始化” → 破坏 Django 生命周期，导致多线程/重载异常，绝对禁止。
? 验证与最佳实践
- 运行
python manage.py check可检测字段引用是否合法； - 使用
python manage.py showmigrations确认模型已正确注册； - 在
settings.py中确保orders和shop均在INSTALLED_APPS中，且顺序无关（Django 会自动解析依赖）。
通过以上两种方式，你既能彻底规避循环导入，又能避免 AppRegistryNotReady 异常，符合 Django 官方推荐模式，适用于生产环境且零副作用。
