Django中如何为自定义过滤的QuerySet在CBV中实现分页？

Hey Jay, 这个问题我之前也碰到过，其实核心是ListView的分页机制是依赖get_queryset()返回的结果来工作的——你直接在get()方法里处理过滤后的QuerySet，但没让视图的分页逻辑感知到这个结果，所以paginate_by没生效。给你两种解决方案，优先推荐第一种，更符合Django CBV的设计思路：

方案一：重写get_queryset方法（推荐） #

ListView本来就设计了get_queryset方法用来定制查询集，把你的过滤、排序逻辑放在这里，paginate_by会自动生效，完全不用手动处理分页：

class SearchListView(ListView):
    model = Store
    template_name = 'boutique/search.html'
    paginate_by = 5

    def get_queryset(self):
        # 从当前请求的GET参数中获取搜索和排序条件
        search_text = self.request.GET.get('search_text')
        sorter = self.request.GET.get('sorter', 'id')  # 给排序字段一个默认值，避免报错

        # 先获取基础的QuerySet（等同于Store.objects.all()）
        queryset = super().get_queryset()

        # 执行过滤逻辑（这里假设根据Store的name字段模糊匹配，你可以换成自己的业务字段）
        if search_text:
            queryset = queryset.filter(name__icontains=search_text)

        # 执行排序逻辑，加白名单校验防止SQL注入风险
        if sorter in ['name', 'price', 'created_at']:
            queryset = queryset.order_by(sorter)

        return queryset

这样修改后，ListView会自动用你返回的过滤后QuerySet进行分页，paginate_by=5直接生效，而且代码结构更清晰，符合Django的最佳实践。

方案二：在get方法中手动绑定处理后的QuerySet #

如果你因为某些复杂业务逻辑，必须在get方法里处理QuerySet，那需要把处理后的结果赋值给self.queryset，再调用父类的get方法，让分页逻辑能获取到这个QuerySet：

class SearchListView(ListView):
    model = Store
    template_name = 'boutique/search.html'
    paginate_by = 5

    def get(self, request, *args, **kwargs):
        search_text = request.GET.get('search_text')
        sorter = request.GET.get('sorter')

        # 处理过滤和排序后的QuerySet
        self.queryset = Store.objects.all()
        if search_text:
            self.queryset = self.queryset.filter(name__icontains=search_text)
        if sorter and sorter in ['name', 'price']:
            self.queryset = self.queryset.order_by(sorter)

        # 调用父类的get方法，让分页逻辑生效
        return super().get(request, *args, **kwargs)

不过这种方式不如方案一优雅，因为get_queryset才是ListView专门用来处理查询集的钩子方法，优先用方案一更好。

模板中渲染分页链接 #

最后别忘了在模板boutique/search.html里添加分页导航，还要把搜索和排序的GET参数带到分页链接里，不然切换页码后会丢失当前的搜索条件：

{% if is_paginated %}
    <div class="pagination-container">
        <span class="page-info">
            第 {{ page_obj.number }} 页 / 共 {{ page_obj.paginator.num_pages }} 页
        </span>
        <span class="page-links">
            {% if page_obj.has_previous %}
                <a href="?page={{ page_obj.previous_page_number }}&search_text={{ request.GET.search_text }}&sorter={{ request.GET.sorter }}">上一页</a>
            {% endif %}
            
            {% for num in page_obj.paginator.page_range %}
                {% if page_obj.number == num %}
                    <span class="current-page">{{ num }}</span>
                {% else %}
                    <a href="?page={{ num }}&search_text={{ request.GET.search_text }}&sorter={{ request.GET.sorter }}">{{ num }}</a>
                {% endif %}
            {% endfor %}
            
            {% if page_obj.has_next %}
                <a href="?page={{ page_obj.next_page_number }}&search_text={{ request.GET.search_text }}&sorter={{ request.GET.sorter }}">下一页</a>
            {% endif %}
        </span>
    </div>
{% endif %}

这里的page_obj是ListView自动传入模板的分页对象，包含了当前页、总页数等信息，is_paginated用来判断是否需要显示分页导航。

内容的提问来源于stack exchange，提问作者Jay P.