Django模型配置带through的m2m字段时报错无_m2m_reverse_name_cache属性的解决办法

核心问题定位 #

触发该报错的核心原因是Django无法自动为through中间表的外键匹配多对多关系的两端模型，导致多对多字段的反向关系初始化异常，访问关联数据时就会找不到_m2m_reverse_name_cache缓存属性。
具体代码层面的问题点：

• 缺少显式through_fields参数：自定义through中间表的场景下，当Django无法100%确定中间表的两个外键分别对应多对多的源模型（定义m2m的Department）和目标模型（User）时，就会初始化失败。当前Department本身还有一个指向User的OneToOneField关联，进一步增加了自动映射的歧义。
• 中间表未设置唯一约束：当前Assistants表允许同一个department和assistant的组合出现多条记录，不符合多对多的业务语义，后续会产生脏数据。
• 多余的symmetrical=False参数：该参数仅用于自引用多对多关系（比如用户互相关注），当前是Department和User的跨模型关联，加这个参数没有实际作用。

解决步骤 #

1. 修改Department模型的m2m字段 #

显式指定through_fields参数，明确告诉Django中间表的外键对应关系：

class Department(models.Model):
    id                  = models.BigAutoField(primary_key=True)
    user                = models.OneToOneField(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
    assistants          = models.ManyToManyField(
        settings.AUTH_USER_MODEL,
        through='Assistants',
        through_fields=('department', 'assistant'),  # 元组顺序：(中间表对应源模型的外键名, 中间表对应目标模型的外键名)
        related_name='dep_assistants'
    )

2. 给Assistants中间表添加唯一约束 #

避免重复关联同一对部门和助理，推荐使用Django 2.2+支持的UniqueConstraint：

class Assistants(models.Model):
    id                  = models.BigAutoField(primary_key=True)
    department          = models.ForeignKey(Department, related_name='of_department', on_delete=models.CASCADE)
    assistant           = models.ForeignKey(settings.AUTH_USER_MODEL, related_name='dt_assistant', 
                            verbose_name="Department Assistant", on_delete=models.CASCADE)
    added               = models.DateTimeField(auto_now_add=True)

    class Meta:
        constraints = [
            models.UniqueConstraint(
                fields=['department', 'assistant'],
                name='unique_dept_assistant'
            )
        ]

如果是低于2.2的Django版本，可以用旧版的unique_together替代：

class Meta:
        unique_together = ('department', 'assistant')

3. 重新生成并执行迁移 #

修改模型后，依次执行迁移命令即可：

• python manage.py makemigrations
• python manage.py migrate

注意事项 #

自定义through中间表的多对多关系，不支持直接调用add()、remove()、set()这类快捷方法操作关联关系，需要手动创建/删除Assistants表的记录，不过读取关联列表的all()操作完全可以正常使用，符合预期的department.assistants.all()调用方式。

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