Django Annotation字典在模板中显示异常，附模型视图代码求助

我来帮你搞定Django里Annotation字典在模板不显示的问题！先结合你给的代码片段，梳理几个最常见的坑和解决办法：

先理清楚你的场景（补全你可能的视图逻辑） #

首先，我猜你是想计算某个用户的平均评分和总评分次数对吧？通常我们会用aggregate来生成带统计值的字典，比如你的视图可能应该是这样的：

from django.db.models import Avg, Count
from django.shortcuts import render

def user_view(request):
    # 假设你要获取当前登录用户的评分统计
    target_user = UserProfile.objects.get(user=request.user)
    # 用aggregate生成统计字典，指定别名方便模板访问
    user_rating_stats = Rating.objects.filter(user_rated=target_user).aggregate(
        avg_stars=Avg('stars'),
        total_ratings=Count('id')
    )
    # 一定要把统计字典传到模板上下文！
    return render(request, 'your_user_template.html', {'stats': user_rating_stats})

模板里的正确访问方式 #

很多人踩坑是因为直接打印整个字典，或者用错了键名：

错误示范（会显示成原始字典字符串）

{{ stats }}  <!-- 输出可能是 {'avg_stars': 4.2, 'total_ratings': 8} -->

正确示范（访问字典的具体键）

<div class="rating-stats">
    <p>平均评分: {{ stats.avg_stars|floatformat:1 }}</p>
    <p>总评分次数: {{ stats.total_ratings|default:0 }}</p>
</div>

这里加floatformat:1是为了让平均评分显示成一位小数，default:0是防止没有评分时显示空值。

常见问题排查清单 #

• 上下文没传对：你视图里的avg和total有没有放到render的第三个参数（上下文字典）里？如果没传，模板肯定拿不到数据！
• 键名搞错了：如果没用别名，Avg('stars')返回的字典键是stars__avg，不是avg！比如：

  # 没指定别名的情况
  stats = Rating.objects.filter(...).aggregate(Avg('stars'), Count('id'))
  # 字典键是 stars__avg 和 id__count
  

  这时候模板里要写{{ stats.stars__avg }}，不如直接给统计值加别名更清晰。
• 混淆了annotate和aggregate：如果用的是annotate（给每个模型实例加注释），返回的是QuerySet，不是字典！比如给所有用户加平均评分：

  users = UserProfile.objects.annotate(avg_rating=Avg('rated__stars'))
  

  模板里要遍历QuerySet才能访问每个用户的avg_rating字段：

  {% for user in users %}
      <p>{{ user.user.username }}: {{ user.avg_rating|default:"暂无评分" }}</p>
  {% endfor %}
  

• 空值处理：如果用户还没有收到任何评分，avg_stars会是None，模板里记得用default过滤器显示友好提示。

按照上面的步骤检查一遍，应该就能解决你的问题啦！

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