drf中嵌套json应使用嵌套序列化器而非jsonfield，因后者不支持结构校验、字段级约束及精细序列化控制；嵌套序列化器可自动递归校验、处理many=true列表、生成层级化错误信息，并保持validated_data为python对象而非字符串。
嵌套JSON字段直接用 JSONField 会丢失验证和序列化控制
如果你把前端传来的嵌套 JSON（比如 {"user": {"name": "Alice", "tags": ["admin", "beta"]}}）直接塞进 JSONField，Django REST Framework（DRF）就只当它是“一坨字符串”，不做结构校验、不支持字段级 required 或 default、也不能在 to_representation 里精细加工。真正需要的是“有结构的 JSON”——也就是嵌套序列化器。
- 别在
Model层用JSONField存嵌套数据再指望 DRF 自动展开；它不认子字段 - 如果数据不对应数据库模型（纯 API 输入/输出），优先用
Serializer类而非ModelSerializer -
JSONField适合存完全动态、无固定 schema 的内容（如日志元数据），不是“假装是对象的 JSON 字符串”
用 Serializer 嵌套定义子结构，而不是手动 to_internal_value
DRF 原生支持嵌套序列化器，不需要重写 to_internal_value 或 to_representation 来解析 JSON 字符串——那是绕路。只要字段名匹配、嵌套层级对得上，DRF 会自动递归处理。
例如处理用户配置：
class UserConfigSerializer(serializers.Serializer):
theme = serializers.ChoiceField(choices=["light", "dark"])
notifications = serializers.DictField(
child=serializers.BooleanField()
)
<p>class UserProfileSerializer(serializers.Serializer):
name = serializers.CharField(max_length=100)
config = UserConfigSerializer() # ← 这就是嵌套，不是 JSONField
</p>
- 前端 POST
{"name": "Bob", "config": {"theme": "dark", "notifications": {"email": true}}}，DRF 自动校验config.theme是否合法、config.notifications.email是否为布尔值 - 反序列化后
serializer.validated_data["config"]是 Python dict，不是字符串 - 如果某层可选，给嵌套字段加
required=False，不要靠allow_null=True混淆语义
嵌套列表怎么写？用 ListSerializer 或 many=True
遇到数组型嵌套（如 "orders": [{"id": 1, "items": [...]}, ...]），别手写循环校验。DRF 提供了更简洁的方式：
- 单个嵌套对象：直接写
OrderSerializer() - 嵌套对象列表：写
OrderSerializer(many=True)，DRF 自动包装成ListSerializer - 如果要给整个列表加约束（比如最多 5 个），用
child+min_length/max_length：serializers.ListField(child=OrderSerializer(), max_length=5) - 避免用
JSONField接收数组再手动json.loads——既重复解析，又绕过字段级错误定位
反序列化失败时错误信息嵌套层级容易被忽略
当嵌套太深（比如 profile.address.city.name）出错，DRF 默认返回的 errors 是扁平键名：{"profile.address.city.name": ["This field is required."]}。但很多前端按对象结构取错，会找不到 city 下的 name 错误。
- 确保前端解析错误时，能按点号路径拆分（或后端改用
error_messages手动聚合） - 测试时用
serializer.is_valid(raise_exception=True)触发异常，看实际抛出的ValidationError内容是否符合预期 - 如果嵌套超过 3 层，考虑拆成多个独立 endpoint，而不是硬塞进一个序列化器——可读性和维护性比“看起来统一”重要得多
嵌套序列化器本身不难，难的是判断哪一层该由 DRF 管、哪一层该交给业务逻辑处理；很多人卡在“以为 JSON 字符串必须先 loads 再校验”，其实 DRF 早就在序列化器层面替你做了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
