Django模板嵌套循环无法正确显示作者对应文章数量问题

出现该问题的核心原因是视图层annotate字段绑定错误或模板层嵌套循环逻辑冗余，annotate方法会直接将统计值绑定到每个查询到的作者实例上，不需要额外嵌套遍历统计结果集，按以下步骤修复即可：

第一步：修正视图层annotate逻辑 #

确保统计字段直接绑定到Author查询集的每个实例上，示例代码如下：

from django.db.models import Count
from .models import Author

# 给每个Author实例附加article_count统计字段，Count内的参数为Article模型关联Author的外键字段的related_name值
authors = Author.objects.annotate(article_count=Count('article')).all()
# 直接将authors传入模板上下文，不需要额外传递单独的统计结果集

第二步：修正模板层循环逻辑 #

删除冗余的内层统计结果循环，直接调用每个作者实例的统计字段即可，示例模板代码如下：

{% for author in authors %}
<p>{{ author.name }}: {{ author.article_count }} articles</p>
{% endfor %}

如果你之前在作者循环内部嵌套了全局统计结果的遍历逻辑，直接删除内层循环即可，annotate已经将对应当前作者的统计值写入了实例属性。

常见错误排查点 #

• 检查annotate中Count方法的参数是否正确：如果Article模型关联Author的外键设置了自定义related_name，需要使用related_name的值作为Count的参数，比如外键定义为author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name="articles")，则Count参数要写为Count('articles')
• 检查传入模板的作者查询集是否是经过annotate处理的结果，而非未附加统计字段的普通查询集
• 不要在模板中单独传入并遍历全局文章统计结果集，避免和作者实例绑定的统计字段混淆

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