Django REST Framework 如何复用已有序列化器字段简化代码编写

你当前遇到的跨序列化器重复定义同名字段的问题，完全可以通过DRF内置的序列化器复用能力解决，不需要逐行手写带source映射的冗余字段，以下是适配你现有业务场景的两种可落地方案：

方案1：嵌套式复用（结构调整友好场景） #

如果你的前端可以适配嵌套式的响应结构，直接将已定义好的UserSerializer作为RelativeSerializerSLC的关联字段即可，零重复定义：

class RelativeSerializerSLC(serializers.ModelSerializer):
    # 直接复用现有UserSerializer，不需要重复编写User相关字段
    user = UserSerializer()

    class Meta:
        model = Relative
        fields = ("user", "blood_group", "rel")
        read_only_fields = ["patient"]

这种写法对应的响应结构为嵌套格式，User相关字段会统一挂载在user键下：

{
  "user": {
    "id": 12,
    "full_name": "张三",
    "rtl_full_name": "张三",
    "gender": "男",
    "phone": "13800138000",
    "email": "zhangsan@example.com",
    "date_of_birth": "1990-01-01",
    "avatar": "https://example.com/avatar.png"
  },
  "blood_group": "O型",
  "rel": "父亲"
}

方案2：平铺式复用（兼容现有接口结构场景） #

如果你的接口已经对接前端，要求User相关字段必须平铺在响应根层级（和你现有旧实现的返回结构完全一致，无需前端改造），可以直接从已有的UserSerializer中提取字段配置，自动映射到关联的user对象属性，完全消除重复定义：

class RelativeSerializerSLC(serializers.ModelSerializer):
    # 从UserSerializer中提取需要复用的字段，自动绑定关联对象的source路径
    _reuse_user_fields = ["full_name", "rtl_full_name", "gender", "phone", "email", "date_of_birth", "avatar"]
    for field_name in _reuse_user_fields:
        field = UserSerializer().fields[field_name]
        # 为字段添加关联对象的source前缀，比如full_name的source自动设为user.full_name
        field.source = f"user.{field_name}"
        locals()[field_name] = field

    class Meta:
        model = Relative
        fields = ("full_name", "rtl_full_name", "gender", "phone", "email", "avatar", "date_of_birth", "blood_group", "rel")
        read_only_fields = ["patient"]

这种写法的核心优势：

• 完全复用UserSerializer中已经定义好的字段类型、校验规则、展示配置，不会出现两个序列化器同名字段定义不一致的问题，同时也避免了你原来手写时把所有关联字段统一定义为CharField，导致字段类型、校验规则丢失的问题
• 后续如果调整User字段的校验逻辑（比如给手机号增加正则格式校验），只需要修改UserSerializer中的对应定义，当前关联序列化器会自动同步生效，不需要两处同步修改
• 最终响应结构和你现有实现100%兼容，前端无需做任何适配调整

落地注意事项 #

• 映射字段前需要确认Relative模型中关联User对象的外键字段名是否为user，如果外键名有调整，只需要修改field.source中的前缀为对应的外键名即可
• 提取复用字段时需要做字段筛选，避免把User模型中的敏感字段（比如密码哈希、隐私信息）不小心透传到接口响应中
• 如果后续需要新增User相关的映射字段，只需要把字段名加到_reuse_user_fields列表里即可，不需要在两个序列化器中重复编写定义

内容的提问来源于stack exchange，提问作者Ali Aref