Django序列化器创建Couple实例后返回空字典问题排查

一、为什么接口返回空字典？ #

你的CreateCoupleSerializer继承自serializers.Serializer，且仅定义了仅用于写入的partner_email字段（write_only=True），没有声明任何用于读取返回的字段。

当视图调用序列化器完成创建后，会尝试将返回的couple实例序列化为响应数据，但序列化器里没有可用于输出的字段，最终就会返回空字典。

解决方法有两种：

1. 手动给序列化器添加需要返回的字段：

class CreateCoupleSerializer(serializers.Serializer):
    partner_email = serializers.EmailField(write_only=True, max_length=250, required=True)
    # 添加用于返回的字段
    id = serializers.UUIDField(read_only=True)
    user1 = serializers.PrimaryKeyRelatedField(read_only=True)
    user2 = serializers.PrimaryKeyRelatedField(read_only=True)

    # 原create方法逻辑不变...

2. 改用ModelSerializer，它会自动根据模型生成序列化字段，再保留partner_email写入字段：

class CreateCoupleSerializer(serializers.ModelSerializer):
    partner_email = serializers.EmailField(write_only=True, max_length=250, required=True)

    class Meta:
        model = Couple
        fields = ['id', 'user1', 'user2', 'partner_email']

    # 原create方法逻辑不变...

二、何时在序列化器的create()写逻辑，何时在视图的create()写？ #

优先放在序列化器create()的场景： #

• 和数据验证、模型实例创建/更新直接相关的逻辑：比如字段格式校验、关联模型的查询绑定、模型实例的保存逻辑，这些属于数据序列化/反序列化的核心职责，放在序列化器里可复用（同一个序列化器能在多个视图中使用）。
• 需要利用序列化器内置机制的逻辑：比如抛出ValidationError，序列化器会自动将异常转化为标准的400错误响应格式，无需手动处理。

优先放在视图create()的场景： #

• 和请求上下文、权限控制相关的逻辑：比如判断当前用户权限、读取请求头信息、处理请求中不属于序列化字段的参数。
• 和响应处理、外部交互相关的逻辑：比如自定义响应格式、调用第三方API、记录请求日志、触发异步任务等。
• 视图独有的业务逻辑：仅当前视图需要的特殊处理，没必要放到序列化器里增加复杂度。

简单总结：序列化器负责数据的转换与校验，视图负责请求的接收与响应，以及绑定业务流程的上下文逻辑。

内容的提问来源于stack exchange，提问作者Mário Prada