如何在Python Django REST Framework中实现复杂的嵌套序列化?

P粉602998670

P粉602998670

2026-06-22

268人浏览

原创

drf默认嵌套序列化器只读,因read_only=true跳过验证与保存逻辑;即使移除该参数,drf也不会自动调用子序列化器的create(),仅尝试将字典塞入父字段导致typeerror或静默丢弃。

如何在python django rest framework中实现复杂的嵌套序列化?

DRF 默认只支持「只读嵌套」,想让 POST/PUT 请求里带嵌套数据并自动保存,必须手动重写 create()update() 方法,或者引入 drf-writable-nested —— 否则字段会静默丢弃,连报错都没有。

为什么默认的嵌套序列化器不能写入

DRF 的 ModelSerializer 对外键、OneToOneFieldForeignKey 关联字段默认只做序列化输出,不处理反向输入。比如你定义了 comments = CommentSerializer(many=True, read_only=True),那前端传来的 {"comments": [...]} 会被直接忽略。

  • read_only=True 是关键开关:它让字段跳过验证和保存逻辑
  • 即使去掉 read_only=True,DRF 也不会自动调用子序列化器的 create() —— 它只会尝试把整个字典塞进父模型字段,结果是 TypeError: Object of type dict is not JSON serializable 或静默失败
  • 多级嵌套(如 Post → Comments → Author)更危险:每层都得自己递归处理,漏一层就断链

手动实现可写嵌套的关键三步

不依赖第三方库时,必须在主序列化器中显式接管关联对象的创建流程。以 Post 带多个 Comment 为例:

Python 3.14.2
Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本,属于3.14系列的第二个维护更新。该版本包含了18项修复,重点解决了多进程、数据类及正则表达式等模块的回归问题,并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式(移除GIL)正式获得官方支持,是Python发展的重要里程碑。

下载
  • PostSerializerMeta.fields 中**不要声明 comments 字段**,否则 DRF 会试图把它当普通字段处理;改用 write_only=True 字段或直接在 create() 里从 validated_data 取原始数据
  • create() 方法里先 post = Post.objects.create(...),再遍历 validated_data.pop('comments', []),逐个调用 CommentSerializer(data=...).is_valid(raise_exception=True).save(post=post)
  • 注意外键赋值方式:Comment.objects.create(..., post=post) 而不是 post.comments.set([...]) —— 后者只适用于已存在的实例,且不触发 CommentSerializer 的验证逻辑

用 drf-writable-nested 省掉重复劳动

如果你的嵌套层级超过两层,或涉及 OneToOneField 正向/反向、多对多(非 through 模型),drf-writable-nested 是更稳的选择。它本质是替你封装了上面的手动逻辑,但有几个硬约束必须遵守:

  • 子序列化器**必须继承 WritableNestedModelSerializer**,不能只是 ModelSerializer
  • 主序列化器的 Meta.model 必须与字段名严格对应关系名,比如 profile = ProfileSerializer() 要求 User.profile 是有效的 OneToOneField 反向关系
  • POST 数据里嵌套字段名必须和序列化器字段名一致,且结构要扁平——drf-writable-nested 不解析深层嵌套键,比如不支持 {"user": {"profile": {...}}} 这种三层结构
  • 安装后记得在 settings.pyINSTALLED_APPS 加上 'drf_writable_nested',否则运行时报 AttributeError: 'UserSerializer' object has no attribute '_get_serializer_for_field'

嵌套序列化的性能坑:N+1 查询怎么破

嵌套序列化本身不触发数据库查询,但 serializer.data 访问嵌套字段时,如果没预加载关联数据,就会当场触发 N+1。比如 PostSerializer(many=True) 返回 10 篇文章,每篇带 5 条评论,没优化就是 1 + 10×5 = 51 次查询。

  • 查列表时用 prefetch_related('comments')(多对一/多对多)或 select_related('author')(一对一/外键)
  • prefetch_relatedmany=True 字段是必须的;select_relatedread_only=True 的单对象字段更高效
  • 别在序列化器里写 queryset = Comment.objects.select_related('author') —— 这只影响该字段单独序列化,不影响父序列化器的 prefetch_related 效果
  • django-debug-toolbar 的 SQL 面板确认是否还有未优化的查询,比猜靠谱

真正麻烦的不是怎么写嵌套,而是搞清「谁负责创建」「谁负责验证」「谁负责关联赋值」——这三个角色在手动实现时全得你指定,在 drf-writable-nested 里则被隐式绑定到字段名和模型关系上。一旦模型关系名改了、字段名拼错了、或忘了加 prefetch_related,问题往往不报错,只表现成数据为空或响应变慢。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1104

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

2047

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1184

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

8588

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1453

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1504

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

860

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

530

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1087

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 教程
Django 教程

共28课时 | 9.1万人学习

Django DRF 源码解析
Django DRF 源码解析

共21课时 | 1.8万人学习

Django参考手册
Django参考手册

共0课时 | 0.1万人学习