filter过滤结果仅对pagination第一页生效的技术问题咨询

核心错误逻辑排查 #

先过滤、后分页是固定执行顺序，但凡后续分页过滤失效，本质都是这个执行顺序被打破，或者过滤参数在后续请求中丢失。 #

常见场景修复方式 #

1. 后端逻辑错误（占比最高） #

错误写法普遍是过滤逻辑只在首次请求触发，或者把未过滤的全量数据集传给分页器：

错误示例（Django/DRF场景）

def get_queryset(self):
    # 错误：仅首次请求从POST拿过滤参数，分页GET请求拿不到参数就直接返回全量
    if self.request.method == "POST":
        keyword = self.request.data.get("keyword")
        return Model.objects.filter(name__contains=keyword)
    return Model.objects.all()

def list(self, request):
    # 分页器拿到的可能是全量未过滤数据集
    page = self.paginate_queryset(self.get_queryset())
    return self.get_paginated_response(ModelSerializer(page, many=True).data)

正确写法

def get_queryset(self):
    # 所有请求统一从查询参数拿过滤条件，每次请求都执行完整过滤
    queryset = Model.objects.all()
    keyword = self.request.query_params.get("keyword")
    if keyword:
        queryset = queryset.filter(name__contains=keyword)
    status = self.request.query_params.get("status")
    if status:
        queryset = queryset.filter(status=status)
    return queryset

def list(self, request):
    # 把过滤完成的数据集传给分页器
    filtered_queryset = self.get_queryset()
    page = self.paginate_queryset(filtered_queryset)
    return self.get_paginated_response(ModelSerializer(page, many=True).data)

2. 前端传参错误 #

切换页码时未携带当前生效的所有过滤参数，仅传递了分页参数：

• 错误请求示例：GET /api/list?page=2（丢失keyword、status等过滤参数）
• 正确请求示例：GET /api/list?keyword=test&status=1&page=2
  修复方式：前端生成分页跳转链接时，把当前所有选中的过滤参数全部附加到请求URL中。

3. 缓存配置错误 #

如果接口配置了返回缓存，缓存key未包含所有过滤参数，会导致不同过滤条件的请求命中同一份缓存数据。
修复方式：把所有过滤参数、分页参数都加入缓存key的生成规则。 #

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