Django模板中无法读取Paginator分页对象问题求助

你的问题根源在于Django ListView的get_queryset方法被错误使用了——这个方法的职责是返回要展示的数据集（查询集或可迭代列表），而不是直接返回上下文字典。你现在返回的字典会被ListView当成查询集来处理，导致pages变量根本没有被正确注入到模板上下文里，只有archives因为和context_object_name同名才碰巧能工作，但这完全是错误的逻辑。

下面给你两种正确的实现方式：

方式一：利用ListView自带的分页功能（推荐） #

ListView已经内置了分页支持，只需要指定paginate_by属性，它会自动帮你处理分页逻辑，同时把分页相关的对象（比如page_obj、paginator）注入到上下文。如果需要自定义pages文本，重写get_context_data添加即可：

from django.views.generic import ListView
from django.core.paginator import Paginator

class ClaimsView(ListView):
    context_object_name = "archives"
    template_name = "myapp/claims.html"
    paginate_by = 4  # 指定每页展示4条数据

    def get_queryset(self):
        # 这里只返回要分页的原始数据集，ListView会自动处理分页
        query = self.request.GET.get("q", "")
        return self.get_archives(query)

    def get_context_data(self, **kwargs):
        # 先调用父类方法获取默认上下文
        context = super().get_context_data(**kwargs)
        # 自定义pages文本，用ListView提供的page_obj和paginator对象
        context['pages'] = f"page {context['page_obj'].number} of {context['paginator'].num_pages}"
        return context

模板里直接用{{ pages }}就能显示你要的内容，还可以利用ListView自带的分页变量做更丰富的分页控件：

<!-- 显示自定义的pages文本 -->
<p>{{ pages }}</p>

<!-- 可选：添加完整的分页导航 -->
{% if is_paginated %}
<div class="pagination">
    {% if page_obj.has_previous %}
        <a href="?page={{ page_obj.previous_page_number }}&q={{ request.GET.q }}">上一页</a>
    {% endif %}
    <span>第 {{ page_obj.number }} 页 / 共 {{ page_obj.paginator.num_pages }} 页</span>
    {% if page_obj.has_next %}
        <a href="?page={{ page_obj.next_page_number }}&q={{ request.GET.q }}">下一页</a>
    {% endif %}
</div>
{% endif %}

方式二：手动处理分页（适合自定义逻辑较多的场景） #

如果不想依赖ListView的自动分页，你可以直接重写get方法，手动处理分页并构造完整的上下文：

from django.views.generic import ListView
from django.core.paginator import Paginator
from django.shortcuts import render

class ClaimsView(ListView):
    context_object_name = "archives"
    template_name = "myapp/claims.html"

    def get(self, request, *args, **kwargs):
        query = request.GET.get("q", "")
        response = self.get_archives(query)
        
        # 手动初始化分页器
        paginator = Paginator(response, 4)
        # 获取当前页码，默认是第1页
        page_number = request.GET.get('page', 1)
        # 获取当前页的对象（自动处理无效页码）
        page_obj = paginator.get_page(page_number)
        
        # 构造上下文字典
        context = {
            'archives': page_obj.object_list,  # 当前页的数据集
            'pages': f"page {page_obj.number} of {paginator.num_pages}",
            'page_obj': page_obj,
            'paginator': paginator
        }
        return render(request, self.template_name, context)

这种方式下模板里的{{ pages }}同样可以正常显示。

额外提醒 #

你原来代码里的paginator.get_pages(4)是错误的——Django的Paginator类没有get_pages方法，正确获取当前页的方法是paginator.get_page(page_number)，它会自动处理页码不存在、非数字等异常情况。

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