Django搜索页分页异常：后续页面重复显示第一页内容

我之前踩过这个分页重复的坑！一眼看下来，问题基本出在视图层的分页逻辑和搜索查询没有正确绑定——每次翻页时，实际查询的数据集没带上搜索条件，或者分页器用了未过滤的全量数据，导致每页都显示第一页的内容。

首先检查视图代码（核心问题所在） #

不管你用的是函数视图还是类视图，最关键的一点是：必须基于过滤后的搜索结果初始化分页器，不能用全量数据分页后再过滤，不然每页都会返回全量数据的前N条，自然重复。

函数视图的正确写法示例

from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
from django.shortcuts import render
from .models import YourModel  # 替换成你的模型类

def search_view(request):
    # 获取搜索关键词
    query = request.GET.get('q', '')
    
    # 第一步：先根据关键词过滤查询集
    if query:
        results = YourModel.objects.filter(title__icontains=query)  # 这里用你实际的搜索过滤逻辑
    else:
        results = YourModel.objects.none()
    
    # 第二步：用过滤后的查询集初始化分页器
    paginator = Paginator(results, 10)  # 每页显示10条，可根据需求调整
    page_num = request.GET.get('page', 1)
    
    # 处理页码异常
    try:
        page_obj = paginator.page(page_num)
    except PageNotAnInteger:
        page_obj = paginator.page(1)
    except EmptyPage:
        page_obj = paginator.page(paginator.num_pages)
    
    # 把查询关键词和分页对象传给模板
    return render(request, 'search.html', {
        'query': query,
        'page_obj': page_obj
    })

类视图（ListView）的正确写法示例

如果你用的是类视图，重点要重写get_queryset方法，确保返回过滤后的结果：

from django.views.generic import ListView
from .models import YourModel

class SearchListView(ListView):
    model = YourModel
    template_name = 'search.html'
    paginate_by = 10
    context_object_name = 'page_obj'

    def get_queryset(self):
        # 获取搜索关键词
        query = self.request.GET.get('q', '')
        # 返回过滤后的查询集
        if query:
            return YourModel.objects.filter(title__icontains=query)
        return super().get_queryset()

    def get_context_data(self, **kwargs):
        # 把查询关键词传到模板，确保翻页链接能带上
        context = super().get_context_data(**kwargs)
        context['query'] = self.request.GET.get('q', '')
        return context

再确认模板的几个细节 #

你的模板代码看起来已经做对了这几点，但还是要检查：

• 确保query变量确实从视图传过来了：翻页时查看页面源代码，确认链接里的q={{ query }}是正确的搜索关键词，而不是空值。如果query没传，翻页时会丢失搜索条件，回到全量数据，也可能导致重复。
• 循环的是page_obj.object_list：你的模板里{% for result in page_obj.object_list %}是正确的，不要改成直接循环object_list（那是未分页的全量数据）。

快速排查步骤 #

1. 在视图里打印results.count()和page_obj.object_list.count()，确认过滤后的结果数量和每页数量符合预期。
2. 点击翻页链接，查看浏览器地址栏的URL，确认q和page参数都正确携带（比如?q=python&page=2）。
3. 如果URL参数正确，但内容还是重复，检查视图里是否不小心把page_obj重复赋值成第一页了。

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