如何基于DRF的ChoiceField创建不区分大小写的自定义选择字段？

自定义字段实现 #

继承DRF的ChoiceField，重写核心方法处理大小写不敏感验证和统一小写输出：

from rest_framework import serializers
from rest_framework.exceptions import ValidationError

class CaseInsensitiveChoiceField(serializers.ChoiceField):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 生成原始选项的小写集合，用于验证
        self.lowercase_valid_choices = {choice.lower() for choice in self.choices}

    def to_internal_value(self, data):
        # 将输入值转为小写，统一验证逻辑
        normalized_input = data.lower()
        if normalized_input not in self.lowercase_valid_choices:
            raise ValidationError(f"无效选项，合法选项为: {', '.join(self.choices)}")
        # 返回小写值，确保后续序列化输出统一为小写
        return normalized_input

    def to_representation(self, value):
        # 强制输出为小写，避免意外情况
        return value.lower()

修改序列化器 #

直接替换原有的ChoiceField为自定义字段即可，无需修改请求体：

my_field_choices = ["A", "BCD", "e"]

class MySerializer(serializers.Serializer):
    my_field = CaseInsensitiveChoiceField(choices=my_field_choices)

工作原理说明 #

1. 初始化阶段：字段初始化时自动将所有合法选项转换为小写并存储为集合，用于后续快速验证。
2. 输入验证：to_internal_value方法处理请求输入，先将输入值转为小写，再与预存的小写合法选项集合比对，通过验证后返回小写值。
3. 输出序列化：to_representation方法确保最终返回的字段值统一为小写，无论输入或原始选项的大小写格式。

这种方式既避免了修改请求体的冗余操作，又完全满足大小写不敏感验证和统一小写输出的需求。

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