Django中如何将ManyToMany关联对象聚合至QuerySet列表？

一、fk_toppings不显示的原因 #

• ManyToManyField是跨表关联字段，不属于Pizza表的直接数据库字段，因此values()只会返回当前模型自身的字段，不会自动包含关联对象。
• 直接打印Pizza对象时，self.fk_toppings是ManyToManyManager实例（用于管理关联关系的工具对象），不是实际的关联数据集合，因此显示my_app.Topping.None。

二、实现关联对象聚合为列表的方法 #

1. 修改__str__方法直接展示关联数据 #

修改Pizza模型的__str__方法，主动获取关联的Topping对象并提取名称：

class Pizza(BaseModel):
    # 保留原有字段定义
    def __str__(self):
        topping_names = ", ".join([t.name for t in self.fk_toppings.all()])
        return f"{self.name} - ({topping_names})"

修改后打印QuerySet时，会直接显示包含配料列表的结果。

2. 数据库层面聚合（推荐） #

PostgreSQL环境（原生支持字符串聚合）

使用Django提供的StringAgg（仅PostgreSQL可用），在QuerySet中直接聚合配料名称：

from django.db.models import StringAgg

# 给每个Pizza对象添加topping_list字段，存储逗号分隔的配料名称
qs = Pizza.objects.annotate(
    topping_list=StringAgg('fk_toppings__name', delimiter=', ')
)

跨数据库兼容方案

如果需要支持多数据库，可以通过预加载+Python层面处理，同时用prefetch_related避免N+1查询：

# 预加载所有关联的Topping，减少数据库查询次数
qs = Pizza.objects.prefetch_related('fk_toppings')

# 手动为每个Pizza添加配料列表属性
for pizza in qs:
    pizza.topping_list = ", ".join([t.name for t in pizza.fk_toppings.all()])

3. 结构化数据场景（values()包含关联列表） #

如果需要在values()返回的字典中包含配料列表，可通过预加载后手动补充：

from django.db.models import Prefetch

# 预加载仅包含name字段的Topping，优化性能
qs = Pizza.objects.prefetch_related(
    Prefetch('fk_toppings', queryset=Topping.objects.only('name'))
).values('id', 'name')

# 为每个字典添加topping_list字段
for item in qs:
    topping_names = list(Topping.objects.filter(toppings_data__id=item['id']).values_list('name', flat=True))
    item['topping_list'] = topping_names

三、Django ORM无内置通用聚合方法的原因 #

• Django ORM是跨数据库抽象层，不同数据库的字符串聚合函数语法、行为差异大：PostgreSQL用string_agg，MySQL用GROUP_CONCAT，SQL Server用STRING_AGG，无法统一成通用的内置API。
• 对于通用场景，Django提供了annotate+自定义聚合的扩展能力，开发者可根据数据库类型选择对应实现，或通过Python层面处理保证兼容性。
• 第三方包如django-group-by是封装了数据库特定的聚合逻辑，简化了使用，但会牺牲部分跨数据库兼容性。

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