Django嵌套分类TabularInline报错：需指定fk_name属性

问题描述 #

我想要创建嵌套分类，Category模型运行正常，代码如下：

class Category(models.Model):
    category_name = models.CharField(max_length=100)
    children_ids = models.ManyToManyField(
        "Category", blank=True, related_name="categories"
    )
    # ... 其他字段

但在Admin面板中添加内联配置时，代码如下：

class ChildrensInline(admin.TabularInline):
    model = Category.children_ids.through

编译器报错：

'categories.Category_children_ids' has more than one ForeignKey to 'categories.Category'. You must specify a 'fk_name' attribute.

尝试设置fk_name='categories'以及中间表的列名，但均无效，请问该如何解决？

解决方案 #

这是因为自关联多对多关系的中间表会自动生成两个指向Category的外键，Django Admin无法自动识别要关联的外键，需要明确指定，或者通过自定义中间表来避免混淆。

方法一：直接指定正确的fk_name #

先通过python manage.py inspectdb命令查看自动生成的中间表结构，找到中间表中指向父分类的外键字段名（通常Django会生成类似category或from_category的字段名），然后在Inline中指定该字段名：

class ChildrensInline(admin.TabularInline):
    model = Category.children_ids.through
    fk_name = 'category'  # 替换为实际中间表中指向父分类的外键字段名

方法二：自定义中间表（更稳妥） #

显式定义中间表，自己控制外键字段名，避免Django自动生成的混淆：

1. 定义中间表：

class CategoryRelationship(models.Model):
    parent = models.ForeignKey(Category, on_delete=models.CASCADE, related_name='child_relationships')
    child = models.ForeignKey(Category, on_delete=models.CASCADE, related_name='parent_relationships')

    class Meta:
        unique_together = ('parent', 'child')  # 避免重复关联

2. 修改Category模型，指定自定义中间表并关闭对称关联：

class Category(models.Model):
    category_name = models.CharField(max_length=100)
    children_ids = models.ManyToManyField(
        "Category", 
        blank=True, 
        related_name="categories",
        through='CategoryRelationship',
        symmetrical=False  # 自关联多对多必须关闭对称，否则逻辑不符合嵌套分类需求
    )
    # ... 其他字段

3. 修改Admin内联配置：

class ChildrensInline(admin.TabularInline):
    model = CategoryRelationship
    fk_name = 'parent'

这样配置后，Admin面板就能正常显示子分类的内联编辑区域了。

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