Django分页器与搜索过滤器正确协同工作的实现方法

首先，必须明确一个核心结论：Django 内置的分页器本身没有问题，真正令人困扰的场景是分页功能与搜索过滤条件协同工作时，点击翻页后搜索参数会丢失。导致这一问题的根源并不复杂——分页链接中仅携带了 page 参数，而用户辛辛苦苦输入的搜索关键词（例如 g_searched）在翻页时被直接丢弃。

具体到你的 group_search.html 模板，分页链接的写法类似 ?page=2，只传递了一个 page 参数。当用户点击“第2页”时，视图层获取到一个不含 g_searched 的 GET 请求。此时 request.GET.get("g_searched", 1) 直接返回默认值 1，接着 Binders.objects.filter(Q(group_id__contains=1)) 就开始错误匹配——这不仅逻辑完全不对，更糟糕的是，1 是一个极其常见的数字，极易引发全表扫描，导致翻页后显示的结果与预期大相径庭。

应该如何处理？思路其实非常直接：让每一个分页链接都忠实地携带原始的搜索参数。实现方式也很简单，使用 Django 内置的 urlencode 过滤器即可安全完成。

推荐方案：在 group_search.html 中，将整个分页导航区域替换为以下版本。它不仅保留了 g_searched，还通过 |urlencode 进行了安全编码，避免空格、&、/ 等特殊字符破坏 URL 结构。

  

    {% if page_obj.has_previous %}
      

        First
      
      

        Previous
      
    {% endif %}
    {% for num in page_obj.paginator.page_range %}
      

        {{ num }}
      
    {% endfor %}
    {% if page_obj.has_next %}
      

        Next
      
      

        Last
      
    {% endif %}
  

这里有几个值得留意的要点：{{ g_searched|urlencode }} 确保了特殊字符被正确编码，不会破坏 URL 结构；page_obj.paginator.page_range 比手动拼接数字列表更加清晰且健壮；active 类的使用让当前页在高亮状态下拥有更好的用户体验。

模板调整完毕后，views.py 也需要相应优化，以提升健壮性与可维护性。

def group_search(request):
    g_searched = request.GET.get("g_searched", "").strip()  # 清除首尾空格，避免无意义的模糊匹配
    group_searched = Binders.objects.all()
    if g_searched:  # 仅当确实存在搜索词时，才触发过滤
        group_searched = group_searched.filter(group_id__icontains=g_searched)  # 推荐使用 icontains 替代 contains，大小写不敏感更友好
    paginator = Paginator(group_searched, 20)
    page_number = request.GET.get('page')
    page_obj = paginator.get_page(page_number)
    context = {
        'g_searched': g_searched,
        'page_obj': page_obj,
        'group_count': group_searched.count(),  # 使用过滤后的 count，结果更准确
    }
    return render(request, "group_search.html", context)

有几个关键细节值得特别强调。第一，切勿将搜索状态存入 session（如 request.session['csv_searched']），这与分页逻辑毫无关联，且 session 不应替代 URL 参数的显式传递。第二，如果未来需要增加多字段过滤（例如日期范围、状态选择），均应统一通过 request.GET 获取并拼接到所有分页链接中，这是最干净的做法。第三，当筛选条件复杂化时，可考虑封装一个工具函数（例如 get_pagination_url(request, page_num)），便于复用。第四，用户输入务必进行 .strip() 和空值判断，防止因意外传入空值而触发全表扫描。

经过这一系列改造，分页链接将始终携带当前的搜索上下文，每一页都基于同一个过滤结果集进行切片，翻页后搜索条件消失的问题便得到彻底解决。