You need to enable JavaScript to run this app. Django 如何将Paginator返回的Page对象转为可序列化JSON
优惠活动
大模型
产品
解决方案
定价
更多

Django 如何将Paginator返回的Page对象转为可序列化JSON

Django分页JSON序列化报错解决方案

报错根因

直接传给JsonResponse的page_obj是Django Paginator模块生成的Page类实例,属于自定义非基础JSON类型对象,JSON解析器无法直接识别并完成序列化,因此触发Object of type Page is not JSON serializable报错。

核心调整逻辑

不要直接将Page实例作为JSON响应返回,需要手动将Page对象携带的可序列化帖子数据、分页状态元信息组装成普通字典/列表结构后,再传入响应方法。

同时推荐调整操作顺序:不要提前对全量Post做序列化,先对原始Post查询集做分页,再仅对当前页的Post实例执行序列化操作,减少不必要的全量关联数据查询开销。

推荐实现代码

from django.core.paginator import Paginator
from django.http import JsonResponse

# 直接对原始查询集做分页,不要提前全量序列化
all_posts = Post.objects.all().order_by("-timestamp")
paginator = Paginator(all_posts, 10)  # 每页最多展示10条帖子
page_obj = paginator.get_page(pagenumber)

# 手动组装可序列化的响应结构
response_data = {
    "posts": [post.serialize() for post in page_obj],  # 仅序列化当前页的帖子
    "has_next": page_obj.has_next(),  # 是否存在下一页
    "has_previous": page_obj.has_previous(),  # 是否存在上一页
    "current_page": page_obj.number,  # 当前页码
    "total_pages": paginator.num_pages,  # 总页数
    "total_posts": paginator.count  # 帖子总数量
}

return JsonResponse(response_data, safe=False)

兼容原有逻辑的写法

如果你确实需要保留“先全量序列化、再分页”的处理顺序,也不能直接返回Page对象,需要从Page实例中取出已序列化的列表内容:

all_posts = Post.objects.all().order_by("-timestamp").all()
serialized_posts = [post.serialize() for post in all_posts]
paginator = Paginator(serialized_posts, 10)
page_obj = paginator.get_page(pagenumber)

# 从page_obj中取出可序列化的当前页数据,搭配分页元信息返回
response_data = {
    "posts": page_obj.object_list,
    "has_next": page_obj.has_next(),
    "has_previous": page_obj.has_previous(),
    "current_page": page_obj.number,
    "total_pages": paginator.num_pages
}
return JsonResponse(response_data, safe=False)

额外注意点

  • 提前全量序列化再分页的写法,会在分页前一次性加载所有帖子的作者、点赞用户关联数据,当帖子数量达到千级以上时,会造成明显的数据库查询压力,优先推荐对原始查询集直接分页的实现方式。
  • 组装响应结构时,可以根据前端分页组件的需求灵活调整需要返回的分页参数,不需要强行照搬示例里的字段。

内容的提问来源于stack exchange,提问作者Vinícius Abner

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 17:36:05