首先,必须明确一个核心结论: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 结构。
这里有几个值得留意的要点:{{ 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() 和空值判断,防止因意外传入空值而触发全表扫描。
经过这一系列改造,分页链接将始终携带当前的搜索上下文,每一页都基于同一个过滤结果集进行切片,翻页后搜索条件消失的问题便得到彻底解决。
