Django ManyToManyField循环导入报错：无法导入未初始化模块中的类

问题原因 #

你遇到的ImportError: 无法从部分初始化的模块中导入Room（注：推测为笔误，实际应为Contact/Account相关模型）本质是循环导入依赖：

• contact.py导入了Account模型
• contactaccount.py同时导入了Account和Contact模型
• 模块初始化阶段互相依赖，导致部分模块未完成初始化就被引用，触发导入错误

解决方案 #

1. 用字符串引用替代直接导入模型 #

在contactaccount.py中删除直接导入语句，改用Django支持的字符串格式模型引用（格式为app_label.ModelName），彻底避免循环导入：

from django.db import models

class ContactAccount(models.Model):
    account = models.ForeignKey('accounting.Account', on_delete=models.CASCADE)
    contact = models.ForeignKey('contact.Contact', on_delete=models.CASCADE)

（注：contact为你的app名称，需替换成实际项目中的对应app名）

2. 修正ManyToManyField的through参数 #

在contact.py中，将through参数改为完整的模型字符串引用，避免隐式依赖：

from django.db import models
from accounting.models.account import Account

class Contact(models.Model):
    id = models.BigAutoField(primary_key=True)
    last_name = models.CharField(max_length=255, blank=True, null=True)
    account = models.ManyToManyField(Account, through='contact.ContactAccount')

3. 检查导入链 #

确保account.py中未导入Contact或ContactAccount相关模块，保持导入逻辑单向无闭环。

修改后完整代码示例 #

contact.py

from django.db import models
from accounting.models.account import Account

class Contact(models.Model):
    id = models.BigAutoField(primary_key=True)
    last_name = models.CharField(max_length=255, blank=True, null=True)
    account = models.ManyToManyField(Account, through='contact.ContactAccount')

contactaccount.py

from django.db import models

class ContactAccount(models.Model):
    account = models.ForeignKey('accounting.Account', on_delete=models.CASCADE)
    contact = models.ForeignKey('contact.Contact', on_delete=models.CASCADE)

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