如何在Django REST Framework中让DecimalField序列化器保留选项验证并返回字符串

架构老林

2026-5-14

解决DecimalField字符串返回+保留选项验证的问题

这个问题的核心原因是你在Serializer里手动定义了vat字段，覆盖了ModelSerializer自动生成的字段——而自动生成的字段会自动继承模型中vat字段的choices验证规则，手动定义时如果没指定choices，自然就丢失了验证。

这里有两种优雅的解决方案，既满足返回字符串格式，又保留模型的选项验证：

方案1：手动指定choices参数

在Serializer的vat字段定义中，直接引用模型的VAT_CHOICES，同时保留coerce_to_string=True：

from .models import Service

class ServiceSerializer(serializers.ModelSerializer):
    vat = serializers.DecimalField(
        decimal_places=2,
        max_digits=10,
        coerce_to_string=True,
        choices=Service.VAT_CHOICES,  # 复用模型的选项规则
    )

    class Meta:
        model = Service
        fields = '__all__'

这样既确保了输入值必须是模型中定义的可选VAT值，又会把响应中的vat以字符串形式返回。

方案2：复用ModelSerializer自动生成的字段（更推荐）

ModelSerializer会根据模型字段自动创建包含所有验证规则（包括choices）的字段，我们只需要在初始化时修改该字段的coerce_to_string属性即可，避免重复定义字段：

class ServiceSerializer(serializers.ModelSerializer):
    class Meta:
        model = Service
        fields = '__all__'

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 找到自动生成的vat字段，开启coerce_to_string
        self.fields['vat'].coerce_to_string = True

这种方式更简洁，且能保证Serializer和模型字段的规则始终一致，后续如果模型的VAT选项有修改，Serializer不需要同步改动。