Django REST Framework嵌套动态字段POST请求的Serializer校验实现

核心思路是先拆分公共字段和不同choice对应的专属字段，再通过动态匹配序列化器的方式完成校验，以下是Django REST Framework（DRF）下的实现示例，其他序列化框架（如Pydantic）可参考相同逻辑实现： #

步骤1：定义options公共字段基础序列化器 #

from rest_framework import serializers

class BaseOptionsSerializer(serializers.Serializer):
    # 所有场景通用的公共字段
    choice = serializers.ChoiceField(choices=["choice1", "choice2"], required=True)
    common_option1 = serializers.CharField(required=True)
    # 场景2不存在该字段，基类中设为非必填，子类可按需覆盖规则
    common_option2 = serializers.CharField(required=False)

步骤2：定义各choice对应的专属序列化器 #

继承基础序列化器，新增对应场景的专属字段，也可覆盖公共字段的校验规则：

# choice取值为choice1时的校验规则
class Choice1OptionsSerializer(BaseOptionsSerializer):
    choice1_option1 = serializers.CharField(required=True)
    choice1_option2 = serializers.CharField(required=True)
    # 覆盖公共字段规则，choice1场景下common_option2为必填
    common_option2 = serializers.CharField(required=True)

# choice取值为choice2时的校验规则
class Choice2OptionsSerializer(BaseOptionsSerializer):
    choice2_option1 = serializers.CharField(required=True)
    choice2_option2 = serializers.CharField(required=True)
    choice2_option3 = serializers.CharField(required=True)

步骤3：定义外层主请求序列化器 #

重写options字段的校验方法，根据choice值动态匹配对应的序列化器做校验：

class MainRequestSerializer(serializers.Serializer):
    name = serializers.CharField(required=True)
    # 先用DictField接收options原始数据
    options = serializers.DictField(required=True)

    def validate_options(self, value):
        choice = value.get("choice")
        if not choice:
            raise serializers.ValidationError("options字段必须包含choice参数")
        
        # 维护choice和对应序列化器的映射关系
        serializer_map = {
            "choice1": Choice1OptionsSerializer,
            "choice2": Choice2OptionsSerializer
        }
        if choice not in serializer_map:
            raise serializers.ValidationError(f"不支持的choice取值：{choice}")
        
        # 调用对应序列化器完成全字段校验
        opt_serializer = serializer_map[choice](data=value)
        if not opt_serializer.is_valid():
            raise serializers.ValidationError(opt_serializer.errors)
        
        # 返回校验完成后的结构化数据，方便后续业务逻辑使用
        return opt_serializer.validated_data

使用说明 #

• 直接传入请求数据调用MainRequestSerializer(data=request.data)即可完成全量校验，无需额外逻辑
• 后续新增其他choice类型时，只需要新增对应场景的序列化器，再更新serializer_map映射关系即可
• 示例中所有字段的类型、必填规则均可根据实际业务需求调整

内容的提问来源于stack exchange，提问作者sumit-sampang-rai