Django多态关系执行迁移时出现外键不匹配错误如何解决？

你遇到的外键不匹配报错，是因为django-polymorphic的PolymorphicModel基于Django多表继承实现，子类Student、Teacher对应的数据库表没有独立的主键约束：子表默认的主键是名为sender_ptr的一对一外键，指向父表Sender的主键，本身没有独立的自增主键索引，数据库无法直接将子表作为外键的参照表，所以触发了报错。

继承自多态模型的子类完全可以作为其他模型的外键使用，以下是三种可行的解决方案：

方案1：外键显式指定关联子表的sender_ptr字段 #

不需要修改现有子类结构，仅需要在Connection的外键定义中添加to_field参数，显式指定关联子表的主键字段sender_ptr即可：

class Connection(models.Model):
    student_id = models.ForeignKey(
        'students.Student',
        to_field='sender_ptr',
        null=False,
        on_delete=models.CASCADE
    )
    teacher_id = models.ForeignKey(
        'teachers.Teacher',
        to_field='sender_ptr',
        null=False,
        on_delete=models.CASCADE
    )
    created_at = models.DateTimeField(auto_now_add=True)
    # 额外提示：你原代码中updated_at用了auto_now_add是错误的，该参数仅会在创建时赋值，更新数据不会修改，应该改为auto_now=True
    updated_at = models.DateTimeField(auto_now=True)

修改后重新生成迁移即可正常运行。

方案2：给子类显式添加独立主键 #

如果后续需要频繁给子类加外键，可以直接给Student和Teacher显式定义独立的自增主键，让子表拥有独立的主键约束，原有外键定义不需要做任何修改：

class Student(Sender):
    # 显式定义独立主键，覆盖默认的sender_ptr主键
    id = models.AutoField(primary_key=True)
    group_name = models.CharField(max_length=100, null=True)

class Teacher(Sender):
    # 显式定义独立主键，覆盖默认的sender_ptr主键
    id = models.AutoField(primary_key=True)
    bio = models.TextField(max_length=255, null=True)

方案3：替换为单表继承范式 #

如果你的Student和Teacher差异字段很少，可以不用django-polymorphic，改用Django原生单表继承实现，所有数据存在同一张表，通过类型字段区分身份，性能更高：

class Sender(models.Model):
    ROLE_CHOICES = (
        ('student', '学生'),
        ('teacher', '教师'),
    )
    role = models.CharField(max_length=20, choices=ROLE_CHOICES, null=False)
    name = models.CharField(max_length=100)
    email = models.EmailField(null=False)
    # 子类差异字段统一放在父表，允许为空
    group_name = models.CharField(max_length=100, null=True)
    bio = models.TextField(max_length=255, null=True)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

# 定义子类代理模型，自带角色过滤
class Student(Sender):
    class Meta:
        proxy = True
    objects = type('StudentManager', (models.Manager,), {
        'get_queryset': lambda self: super().get_queryset().filter(role='student')
    })()

class Teacher(Sender):
    class Meta:
        proxy = True
    objects = type('TeacherManager', (models.Manager,), {
        'get_queryset': lambda self: super().get_queryset().filter(role='teacher')
    })()

这种范式下Connection的外键直接关联Sender即可，仅需要额外添加数据校验保证关联的对象角色符合要求即可。

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