Django ListView使用get_context_data时的分页异常问题

问题描述 #

使用Django ListView实现按标签筛选问题并分页，筛选逻辑正常，但分页功能异常：

• 当查询结果有8条数据，设置paginate_by=10时仅显示1页（符合预期）；
• 设置paginate_by=3时，分页控件显示3页（正确），但每页却展示所有查询结果。

问题原因 #

核心问题出在get_context_data方法中：你手动将未分页的完整查询集赋值给了context['questions']，覆盖了ListView自动生成的分页后查询集。分页控件基于get_queryset返回的结果计算分页逻辑，但页面实际展示的是你手动传入的完整数据，导致分页控件显示正确但内容未分页。

同时，get_queryset和get_context_data中的查询条件不一致（前者未过滤is_deleted=False），进一步导致分页计算和展示数据不匹配。

代码修正 #

1. 修改views.py #

将过滤条件整合到get_queryset中，移除get_context_data里对questions的重新赋值，同时指定context_object_name让ListView自动处理分页后的查询集：

class TagQuestionsListView(ListView):
    template_name = 'main/tag_questions.html'
    paginate_by = 3  # 可根据需求调整数值
    context_object_name = 'questions'  # 指定分页后数据的context变量名

    def get_queryset(self):
        tag = Tag.objects.get(name=self.kwargs['name'])
        # 整合is_deleted过滤条件，确保分页计算和展示数据一致
        return Question.objects.filter(tags=tag, is_deleted=False)

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        # 仅添加tag到context，无需重复查询questions
        context['tag'] = Tag.objects.get(name=self.kwargs['name'])
        # 可选：添加总问题数到context，用于页面显示
        context['total_questions_count'] = self.get_queryset().count()
        return context

2. 模板优化（可选） #

模板中使用paginator.count或自定义的total_questions_count获取总数据量，确保显示正确的总数：

<!-- 替换原来的标题和总数显示部分 -->
<h3 class="ms-2" style="display: inline;">Ultime {{ paginator.count }} Domande</h3>
<h5 class="ms-2">{{ total_questions_count }} domande totali </h5>

关键注意点 #

• ListView会自动对get_queryset返回的查询集进行分页，并将分页后的数据放入context：
  • 默认变量名是object_list；
  • 若指定context_object_name，则使用该名称（如上述的questions）；
• 分页相关变量（page_obj、paginator）由ListView自动注入到context中，无需手动处理；
• 不要在get_context_data中覆盖分页相关的context变量，否则会破坏ListView的分页逻辑。

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