如何在自关联Menu模型中使用prefetch_related获取菜单及子菜单

这问题我之前也碰到过，核心是没搞清楚Django中自关联ForeignKey的反向关系用法，以及prefetch_related的正确姿势。我给你一步步拆解解决：

1. 先修正Menu模型的定义 #

一定要给自关联的ForeignKey设置related_name，这能避免默认的menu_set这种容易搞混的名字，让代码更直观：

from django.db import models

class Menu(models.Model):
    name = models.CharField(max_length=100)  # 假设你有名称字段，方便演示
    parent = models.ForeignKey(
        'self',
        on_delete=models.CASCADE,
        null=True,
        blank=True,
        related_name='children'  # 关键：把反向关联命名为children，对应子菜单
    )

    def __str__(self):
        return self.name

2. 正确查询父菜单并预取子菜单 #

你需要先筛选出所有parent为None的父菜单，再通过prefetch_related预取它们的子菜单（也就是我们设置的children反向关联）：

from your_app.models import Menu

# 一次性加载所有父菜单和对应的子菜单，彻底避免N+1查询
parent_menus = Menu.objects.filter(parent__isnull=True).prefetch_related('children')

3. 循环打印时的正确姿势 #

注意**必须调用.all()**来获取子菜单集合！因为parent.children本质是一个RelatedManager对象，直接打印它就会显示类似app.Menu.None的结果，正确循环方式：

for parent in parent_menus:
    print(f"父菜单：{parent.name}")
    print("子菜单列表：")
    # 调用.all()拿到实际的子菜单QuerySet
    for child in parent.children.all():
        print(f"- {child.name}")
    print("---")

如果你没设置related_name的兼容方案 #

要是之前没设置related_name，Django会默认生成menu_set作为反向关联名称，这时候查询和循环要改成：

# 查询
parent_menus = Menu.objects.filter(parent__isnull=True).prefetch_related('menu_set')

# 循环
for parent in parent_menus:
    for child in parent.menu_set.all():
        print(child.name)

你之前出错的核心原因 #

1. 要么没设置清晰的related_name，导致调用反向关联时名字错误；
2. 要么直接访问了反向关联的管理器对象（比如parent.children）而没有调用.all()，所以打印出了管理器的默认表示，而非实际子菜单数据；
3. 要么prefetch_related没有指定正确的反向关联名称。

这样修改后，就能一次性加载所有父菜单和子菜单，避免循环时的重复数据库查询，也能正确显示子菜单内容了。

内容的提问来源于stack exchange，提问作者Selim Yılmaz