Django如何使用annotate拼接外键关联ISBN字段生成捆绑包标识

完全可以通过annotate配合字符串聚合函数实现，彻底解决原循环写法的N+1查询问题，生产环境性能提升显著。

前置依赖 #

Django 2.2及以上版本内置了StringAgg聚合函数，支持跨关联表分组拼接字符串，适配PostgreSQL、MySQL、SQLite等主流数据库。

核心实现代码 #

from django.db.models import StringAgg

# 单次查询直接拿到所有Bundle的拼接后ISBN标识
bundles = Bundle.objects.annotate(
    complex_isbn=StringAgg(
        'book__isbn',  # 关联Book表的isbn字段
        ' & ',  # 拼接分隔符
        ordering='book__isbn'  # 可选：固定ISBN排序顺序，保证同一Bundle的标识唯一
    )
)

# 直接读取注解字段即可，无需额外查询
for bundle in bundles:
    print(bundle.name, bundle.complex_isbn)

如果需要直接导出结构化数据，可直接通过values_list一次性拿到结果：

export_data = Bundle.objects.annotate(
    complex_isbn=StringAgg('book__isbn', ' & ', ordering='book__isbn')
).values_list('name', 'complex_isbn')

注意事项 #

1. 若使用MySQL作为底层数据库，StringAgg底层调用GROUP_CONCAT，默认最大拼接长度为1024字节，当单个Bundle关联的Book数量较多时可能出现内容截断，可调整数据库参数group_concat_max_len解决。
2. 若Django版本低于2.2，可对应数据库使用原生聚合函数实现，优先推荐升级Django版本使用内置兼容实现。

性能对比 #

原循环写法属于典型的N+1查询问题：1次查询所有Bundle，每遍历1个Bundle额外发起1次关联Book的查询，假设有1000个Bundle就会产生1001次数据库请求。
使用annotate+StringAgg的方案仅发起1次数据库请求，数据量越大性能优势越明显。

内容的提问来源于stack exchange，提问作者S.D.