ModelSerializer未转成JSON是因为未调用.data属性；必须先调用.is_valid()（反序列化）或确保传入有效实例（序列化），再取serializer.data得到字典，最后json.dumps()才可得JSON字符串。
ModelSerializer 为啥没转成 JSON？先看序列化器有没有调用 .data
DRF 的 ModelSerializer 实例本身不是 JSON，它只是个中间对象。不调用 .data 属性，永远拿不到可序列化的字典——更别说 JSON 了。常见错误是直接对 serializer 做 json.dumps(serializer)，结果报 TypeError: Object of type ModelSerializer is not JSON serializable。
- 必须先调用
.is_valid()（如果是反序列化）或确保传入了有效实例（序列化时） - 再取
serializer.data，得到的是OrderedDict或普通dict - 最后用
json.dumps(serializer.data)才能得到 JSON 字符串 - 视图里通常不用手动
dumps，DRF 的Response会自动处理；但单元测试、脚本导出等场景容易漏这步
单个对象 vs 列表：many=True 忘加就崩
序列化 QuerySet 或列表时，必须显式传 many=True，否则 serializer.data 会尝试把整个列表当单个模型实例处理，抛出 AttributeError: 'list' object has no attribute '_meta'。
- 序列化单个模型实例：
serializer = UserSerializer(user_instance) - 序列化多个：
serializer = UserSerializer(queryset, many=True) -
many=True会影响.data返回结构（外层是 list），也影响字段校验逻辑（比如required=False在列表中行为不同） - 别依赖“自动推断”，DRF 不猜你的意图
字段没显示？检查 fields 和 read_only_fields 配置
默认只序列化模型字段，但如果你自定义了 fields，又没把需要的字段列进去，或者误设了 read_only_fields，字段就会静默消失——不是报错，是根本不出现在 .data 里。
-
fields = '__all__'最省事，但要注意敏感字段（如password）得额外排除 - 用
exclude = ['password']比在fields里漏写更安全 -
read_only_fields只控制反序列化行为，不影响序列化输出；字段消失大概率是fields配置问题 - 调试时直接打印
serializer.fields，看实际加载了哪些字段
嵌套序列化器返回空字典？确认关联对象存在且已 select_related / prefetch_related
比如 UserSerializer 嵌套了 ProfileSerializer，但 user.profile 是 None 或数据库没查出来，嵌套字段就是空字典或被跳过——不是 bug，是 DRF 的默认安全行为。
- 查数据库时记得用
select_related('profile')（一对一）或prefetch_related('posts')（一对多） - 嵌套字段默认
required=False，所以即使关联对象不存在也不报错，但数据就没了 - 想强制返回 null 而不是跳过，给嵌套字段加
allow_null=True并确保required=False - 用
print(serializer.instance.profile)快速验证关联对象是否真能取到
.data、many 开关有没有拨对、字段配置是不是漏了、关联对象到底查没查。这些点不报红，但数据就是不对。 
