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
相关产品推荐
相关产品推荐

