Django：context传递的查询集数据无法在模板中正常渲染显示

模板遍历sorted_courses无内容显示的核心原因是查询返回的数据结构和模板取值逻辑不匹配：

• 视图中用UserCourse.objects.values("course")做聚合查询时，返回的结果字典仅包含course（存储关联Course的主键ID）、count两个键，不存在course_title字段，模板取值自然为空
• 额外用Python内置sorted()处理QuerySet得到原生字典列表本身没有问题，但前提是字典内存在模板要访问的键，缺字段就会导致渲染空白

推荐直接修改视图层查询逻辑，不需要调整现有模板代码即可正常渲染：

# views.py 中dashboard视图修改后代码
@login_required
def dashboard(request):
    ...
    # 直接查询Course模型，关联统计每个课程的选课人数，按人数倒序排列
    sorted_courses = Course.objects.annotate(
        count=models.Count("usercourse")
    ).order_by("-count")
    
    context = {
        'course_counts': UserCourse.objects.values("course").annotate(count=models.Count("course")),
        'sorted_courses': sorted_courses,
    }
    return render(request, 'dashboard/dashboard.html', context)

该写法返回的每一项都是完整的Course模型实例，模板中原本写的{{ course.course_title }}可以直接读取到对应字段值，后续需要调用Course的其他字段（比如课程创建者、课程创建时间等）也不需要额外修改查询逻辑，灵活性更高。

如果希望继续用字典结构返回数据，也可以在values查询时跨表取出需要的课程标题字段，同时直接用ORM的order_by完成排序，省去Python层排序的性能开销：

@login_required
def dashboard(request):
    ...
    sorted_courses = UserCourse.objects.values(
        "course", "course__course_title"
    ).annotate(
        count=models.Count("course")
    ).order_by("-count")
    
    context = {
        'course_counts': UserCourse.objects.values("course").annotate(count=models.Count("course")),
        'sorted_courses': sorted_courses,
    }
    return render(request, 'dashboard/dashboard.html', context)

对应模板需要调整取值的键名：

{% for course in sorted_courses %}
    <h1>{{ course.course__course_title }}</h1>
{% endfor %}

如果代码修改后仍然没有内容显示，先做两项检查：

• 确认数据库中UserCourse表存在实际的选课关联记录，查询集为空时for循环不会渲染任何内容属于正常表现
• 检查视图中省略的业务逻辑是否对查询结果做了额外过滤，导致符合条件的课程被筛除

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