Django ORM处理自关联外键报错原因及适配已有Schema方案

为什么会出现parent_id_id的错误？ #

Django的ForeignKey字段有个默认约定：模型中定义的ForeignKey字段名，会自动在数据库中对应字段名_id的列。比如你定义了parent_id = models.ForeignKey('self')，Django会默认认为数据库里的关联列是parent_id_id，但你的实际数据库列是parent_id，这就导致了查询时找不到字段的报错。

适配现有数据库Schema的解决方案 #

因为你不能修改已有的数据库结构，所以需要调整Django模型的定义，让它正确映射到数据库的parent_id列：

正确的模型定义 #

class Categories(models.Model):
    id = models.AutoField(primary_key=True)
    # 把字段名改为`parent`，Django默认会映射到数据库的`parent_id`列
    # 显式指定db_column更稳妥，避免歧义
    parent = models.ForeignKey(
        'self',
        on_delete=models.SET_NULL,  # 根据业务需求选择，比如根分类允许父级为null就用SET_NULL
        null=True,  # 对应数据库中parent_id可为空的情况
        related_name='children',  # 方便反向查询子分类
        db_column='parent_id'  # 明确指定数据库中的列名
    )

    class Meta:
        managed = False  # 告诉Django不要自动管理这个表的结构
        db_table = 'categories'  # 指定对应的数据库表名

查询示例 #

• 获取分类1的所有子分类：

from myapp.models import Categories
root_category = Categories.objects.get(id=1)
sub_categories = root_category.children.all()
print(sub_categories)
# 输出：<QuerySet [<Categories: Categories object (2)>, <Categories: Categories object (3)>]>

• 获取分类2的父分类：

sub_category = Categories.objects.get(id=2)
parent_category = sub_category.parent
print(parent_category)
# 输出：<Categories: Categories object (1)>

补充说明 #

如果不想修改字段名（比如非要叫parent_id），也可以通过db_column强制指定列名：

parent_id = models.ForeignKey(
    'self',
    on_delete=models.SET_NULL,
    null=True,
    related_name='children',
    db_column='parent_id'  # 直接指定数据库列名
)

不过更推荐用parent作为字段名，符合Django的命名规范，代码可读性更高。

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