如何在Django Serializer中排除指定字段验证并检查可选字段存在

我有一个用于接收设置变更的FrameImageSerializer，要求请求中至少包含一个非必填的设置字段（is_active、is_fullscreen、resolution），但当前的validate函数会把dot_id和user_id也纳入校验逻辑，导致仅提交这两个必填字段时不会触发错误。

我尝试过两种方案，但都不理想：

• 尝试用data[2:]截取字段，触发错误：TypeError: unhashable type: 'slice'
• 判断len(data) == 2，但感觉这种实现不够优雅，想找更优的方式

附上Serializer代码：

class FrameImageSerializer(serializers.Serializer):
    dot_id = serializers.IntegerField()
    user_id = serializers.IntegerField()
    is_active = serializers.BoolField(required=False)
    is_fullscreen = serializers.BoolField(required=False)
    resolution = serializers.ListField(
        required=False,
        min_length=4,
        max_length=4
    )

    class Meta:
        fields = "__all__"

    def validate(self, data):
        if not data:  # except for dot_id and user_id...
            raise serializers.ValidationError(
                "At least one setting change needs to be present!"
            )
        return data

解决方案 #

方式一：明确指定设置字段集合，检查是否有提交 #

这种方式逻辑清晰，可读性强，后续维护设置字段时只需修改集合即可：

class FrameImageSerializer(serializers.Serializer):
    dot_id = serializers.IntegerField()
    user_id = serializers.IntegerField()
    is_active = serializers.BoolField(required=False)
    is_fullscreen = serializers.BoolField(required=False)
    resolution = serializers.ListField(
        required=False,
        min_length=4,
        max_length=4
    )

    class Meta:
        fields = "__all__"

    def validate(self, data):
        # 定义需要校验的设置字段
        setting_fields = {'is_active', 'is_fullscreen', 'resolution'}
        # 检查是否有至少一个设置字段出现在提交的数据中
        has_valid_change = any(field in data for field in setting_fields)
        
        if not has_valid_change:
            raise serializers.ValidationError(
                "At least one setting change needs to be present!"
            )
        return data

方式二：排除必填字段后检查剩余字段数量 #

如果不想硬编码设置字段列表，可以通过排除dot_id和user_id来判断是否有其他字段提交：

class FrameImageSerializer(serializers.Serializer):
    # 字段定义不变
    dot_id = serializers.IntegerField()
    user_id = serializers.IntegerField()
    is_active = serializers.BoolField(required=False)
    is_fullscreen = serializers.BoolField(required=False)
    resolution = serializers.ListField(
        required=False,
        min_length=4,
        max_length=4
    )

    class Meta:
        fields = "__all__"

    def validate(self, data):
        excluded_fields = {'dot_id', 'user_id'}
        # 筛选出除必填字段外的其他字段
        submitted_settings = [key for key in data if key not in excluded_fields]
        
        if not submitted_settings:
            raise serializers.ValidationError(
                "At least one setting change needs to be present!"
            )
        return data

两种方式对比：

• 方式一适合设置字段固定的场景，明确直观，不易出错；
• 方式二更灵活，后续新增非必填设置字段时无需修改校验逻辑。

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