Django多表继承与自定义中间表多对多在Admin内联中外键约束失败

解决步骤 #

1. 修改MenuLevel模型中字段的related_name属性，避免与Django内置属性冲突：

class MenuLevel(models.Model):
    menu = models.ForeignKey(Menu, on_delete=models.CASCADE)
    # 将menu_item的related_name改为更清晰的名称
    menu_item = models.ForeignKey(MenuItem, on_delete=models.CASCADE, related_name='menu_level_items')
    level = models.IntegerField(default=0)
    # 修改parent字段的related_name，避免与多表继承的内置属性冲突
    parent = models.ForeignKey(MenuItem, on_delete=models.CASCADE, related_name='menu_level_parents', null=True, blank=True)

2. 执行数据库迁移，应用模型修改：

python manage.py makemigrations
python manage.py migrate

问题根源 #

你遇到的外键约束错误，核心原因是MenuLevel模型的parent字段使用了related_name='parent'。在Django的多表继承机制中，子类（如Page、Category）会自动生成一个名为_parent的内置属性，用于关联父类MenuItem的记录。当你将related_name设为parent时，会与这个内置属性产生命名冲突，导致Django在处理跨子类的外键关联时出现逻辑错误，最终触发IntegrityError。

当两个Category设置为父子关系时，由于属于同一子类，冲突的影响未显现；但跨子类（Category作为父、Page作为子）关联时，命名冲突导致的逻辑错误被触发，从而抛出异常。

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