Django REST Framework动态收藏表分页数据丢失问题求助

表结构与操作逻辑 #

• 用户标记物品Y为收藏时，表中新增一条记录：

  id	user_id	item_id	is_active
  ...	X	Y	true

• 用户取消对物品Y的收藏时，对应记录的is_active字段设为false：

  id	user_id	item_id	is_active
  ...	X	Y	false

• 用户重新收藏物品Y时，通过Django的create_or_update()方法将对应记录的is_active设为true

示例表数据 #

当前查询与分页问题 #

用户1001请求收藏列表时，查询语句为：

queryset = Favorite.objects.filter(user=1001, is_active=True)

返回的有效记录ID为：[1, 2, 3, 4, 5]

当分页大小设为2时，第一页响应为：

{
  "next": "...?page=2",
  "previous": null,
  "data": [1, 2]
}

此时用户1001取消对物品202的收藏（记录ID=2的is_active变为false），再请求第2页时，响应变成：

{
  "next": "...?page=3",
  "previous": "...?page=1",
  "data": [4, 5]
}

记录ID=3丢失了

问题 #

如何解决该问题？最佳实践是什么？我忽略了哪些要点？

我并非专业程序员，恳请提供帮助，可调整表结构或查询方法等任何内容。

解决方法与最佳实践 #

1. 改用游标分页替代偏移量分页

偏移量分页（依赖page和page_size）的核心问题是：当数据集动态变化（比如某条记录被过滤掉）时，后续页面的偏移计算会错位。游标分页基于唯一、有序的字段（比如id）来定位，能彻底避免这个问题：

• 第一页请求：?limit=2，返回数据[1,2]，同时返回最后一条记录的id=2作为游标
• 第二页请求：?limit=2&after=2，查询条件改为filter(user=1001, is_active=True, id__gt=2)，会得到[3,4]
• 即使记录2被标记为false，第二页查询依然会找到id>2的有效记录，不会丢失ID=3

Django中可以自己简单实现游标分页：

from django.http import JsonResponse

def get_user_favorites(request):
    user_id = request.user.id  # 或从请求参数获取
    limit = int(request.GET.get('limit', 2))
    after_id = request.GET.get('after')

    # 按id升序排列，保证顺序稳定
    queryset = Favorite.objects.filter(user=user_id, is_active=True).order_by('id')
    if after_id:
        queryset = queryset.filter(id__gt=after_id)
    
    results = list(queryset[:limit])
    next_after = results[-1].id if len(results) == limit else None

    return JsonResponse({
        "next": f"?limit={limit}&after={next_after}" if next_after else None,
        "previous": None,  # 如需支持上一页，可添加before参数和id__lt过滤
        "data": [obj.id for obj in results]
    })

2. 优化表结构：添加时间戳字段

在Favorite表中新增updated_at字段（记录收藏状态更新的时间），分页时按updated_at倒序排列，结合游标分页。这样用户最新收藏的物品会排在前面，同时排序依据更符合用户使用习惯，也能避免偏移量分页的问题。

3. 临时过渡方案：提示用户数据更新

如果暂时无法修改分页逻辑，可以在查询时固定排序（比如按id升序），当用户切换页面时，检查当前数据集的总数是否和之前请求时的总数不一致，若不一致则提示“收藏列表已更新，请重新查看”，但这只是临时方案，用户体验不如游标分页。

你忽略的核心要点

• 偏移量分页不适合动态变化的数据集：当数据被添加、移除或过滤条件变化时，偏移量会导致数据重复或丢失
• 分页必须依赖稳定的排序字段：排序依据需要是唯一且不会频繁变化的（比如id、created_at），否则分页结果会出现混乱

内容的提问来源于stack exchange，提问作者Jim.Z