Django过滤后分页异常问题求助

云原生阿岚

2026-5-11

解决Django过滤后分页丢失搜索条件的问题

我来帮你拆解问题根源，然后一步步搞定它：

问题核心原因

请求方法不匹配：你当前只在POST请求时处理过滤逻辑，但分页链接触发的是GET请求。点击第二页时，浏览器发送GET请求，视图会走初始逻辑（直接用Contracts.objects.all()），完全忽略之前的搜索过滤条件。
分页未携带搜索参数：分页后的URL只有?page=2，没有带上你之前输入的搜索关键词，视图根本不知道你要分页的是过滤后的数据集。
代码细节错误：比如context里的queryset1未定义，POST分支里user_list = queryset应该指向过滤后的queryset2，还有异常处理里的变量名混乱（一会用users一会用queryset）。

修复步骤

1. 把搜索表单改成GET提交（更适配搜索场景）

在模板的表单标签里加上method="get"，这样搜索参数会直接附在URL上，分页链接自然就能继承这些参数：

<!-- customer1.html 中的表单部分 -->
<form method="get">
    {{ form.as_p }}
    <button type="submit">搜索</button>
</form>

2. 重构视图逻辑，统一处理搜索与分页

把过滤逻辑从POST判断中抽出来，同时兼容GET/POST参数，确保不管是提交搜索还是点击分页，都能正确识别搜索条件：

# views.py
from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger

def list_contract(request):
    header = "LIST OF CONTRACT"
    # 优先从GET获取参数（因为表单改成GET提交），兼容POST场景
    form = ContractSearchForm(request.GET or request.POST or None)
    queryset = Contracts.objects.all()

    # 处理过滤逻辑，只有表单验证通过时才过滤
    if form.is_valid():
        contract_keyword = form.cleaned_data.get('contract', '')
        name_keyword = form.cleaned_data.get('name', '').upper()
        queryset = Contracts.objects.filter(
            contract__icontains=contract_keyword,
            name__icontains=name_keyword
        )

    # 统一处理分页逻辑，避免重复代码
    paginate_by = request.GET.get('paginate_by', 10)
    # 处理非法的分页条数输入
    try:
        paginate_by = int(paginate_by)
    except ValueError:
        paginate_by = 10

    paginator = Paginator(queryset, paginate_by)
    page = request.GET.get('page', 1)

    try:
        queryset = paginator.page(page)
    except PageNotAnInteger:
        queryset = paginator.page(1)
    except EmptyPage:
        queryset = paginator.page(paginator.num_pages)

    context = {
        "form": form,
        "header": header,
        "queryset": queryset,
        'paginate_by': paginate_by,
    }
    return render(request, "customer1.html", context)

3. 确保分页链接保留搜索参数

你用的param_replace模板标签需要能自动保留当前URL的所有参数（包括搜索关键词），如果你的标签实现有问题，可以用这个标准版本：

# 在你的app下创建 templatetags/param_replace.py
from django import template

register = template.Library()

@register.simple_tag(takes_context=True)
def param_replace(context, **kwargs):
    # 复制当前GET参数
    d = context['request'].GET.copy()
    # 更新传入的参数（比如page）
    for k, v in kwargs.items():
        d[k] = v
    # 删除空值参数
    for k in [k for k, v in d.items() if not v]:
        del d[k]
    # 编码成URL参数格式
    return d.urlencode()

然后在模板顶部加载标签：{% load param_replace %}，这样分页链接就会变成?contract=xxx&name=yyy&page=2的形式，视图能正确识别并分页过滤后的结果。

额外优化小建议

如果暂时不用export_to_CSV字段，可以先从表单里移除，避免干扰过滤逻辑；
表单里的use_required_attribute = False可以保留，避免空搜索时的字段必填提示。

这样修改后，你点击分页链接时就会带着搜索参数，视图会自动重新过滤并返回对应页码的正确结果了。

内容的提问来源于stack exchange，提问作者Dinh Truong Anh Phuong