Django CrispyForms DecimalField验证：限制输入或自定义错误提示

一、能不能在表单__init__里加验证逻辑？ #

完全可以。你可以在__init__方法里给字段加验证器、修改错误提示或者配置输入限制。不过Django表单更推荐用clean_<字段名>方法做字段级验证，逻辑会更清晰。下面分别讲两种效果的具体实现：

二、实现效果a：限制用户只能输入数字和小数点 #

方式1：前端输入限制（在__init__里配置） #

直接给forex_rate的输入框加HTML属性，让浏览器限制输入类型：

class ForexForm(forms.ModelForm):
    class Meta:
        model = Forex
        fields = ['currency_code', 'forex_rate']

    def __init__(self, *args, **kwargs):
        super(ForexForm, self).__init__(*args, **kwargs)
        self.fields['currency_code'].error_messages = {'required': 'Currency Code Cannot Be Blank',
                                                       'unique': 'Forex Rate Already Exists!'}
        self.fields['forex_rate'].error_messages = {'required': 'Forex Rate Cannot Be Blank'}
        # 限制输入仅数字+小数点，step对应你的decimal_places=4
        self.fields['forex_rate'].widget.attrs.update({
            'type': 'number',
            'step': '0.0001',
            'inputmode': 'decimal'
        })

注意：前端限制可以被绕过，一定要配合后端验证。

方式2：后端验证器（在__init__里注入） #

先写个验证函数，再加到字段的验证器列表里：

def check_decimal_input(value):
    try:
        # 用Decimal更严谨，对应模型的DecimalField
        from decimal import Decimal
        Decimal(str(value))
    except ValueError:
        raise forms.ValidationError("仅可输入十进制数值")

class ForexForm(forms.ModelForm):
    class Meta:
        model = Forex
        fields = ['currency_code', 'forex_rate']

    def __init__(self, *args, **kwargs):
        super(ForexForm, self).__init__(*args, **kwargs)
        self.fields['currency_code'].error_messages = {'required': 'Currency Code Cannot Be Blank',
                                                       'unique': 'Forex Rate Already Exists!'}
        self.fields['forex_rate'].error_messages = {'required': 'Forex Rate Cannot Be Blank'}
        # 给forex_rate加自定义验证器
        self.fields['forex_rate'].validators.append(check_decimal_input)

三、实现效果b：显示自定义错误提示 #

方式1：直接修改字段默认错误提示（__init__里搞定） #

DecimalField自带invalid错误类型，直接替换成你的自定义提示就行：

class ForexForm(forms.ModelForm):
    class Meta:
        model = Forex
        fields = ['currency_code', 'forex_rate']

    def __init__(self, *args, **kwargs):
        super(ForexForm, self).__init__(*args, **kwargs)
        self.fields['currency_code'].error_messages = {'required': 'Currency Code Cannot Be Blank',
                                                       'unique': 'Forex Rate Already Exists!'}
        self.fields['forex_rate'].error_messages = {
            'required': 'Forex Rate Cannot Be Blank',
            'invalid': '仅可输入十进制数值'  # 替换默认的无效格式提示
        }

方式2：用clean方法自定义验证（更灵活） #

如果需要更复杂的验证逻辑，就写clean_forex_rate方法：

class ForexForm(forms.ModelForm):
    class Meta:
        model = Forex
        fields = ['currency_code', 'forex_rate']

    def __init__(self, *args, **kwargs):
        super(ForexForm, self).__init__(*args, **kwargs)
        self.fields['currency_code'].error_messages = {'required': 'Currency Code Cannot Be Blank',
                                                       'unique': 'Forex Rate Already Exists!'}
        self.fields['forex_rate'].error_messages = {'required': 'Forex Rate Cannot Be Blank'}

    def clean_forex_rate(self):
        rate = self.cleaned_data.get('forex_rate')
        if not rate:
            return rate
        # 检查是否包含非数字字符（仅允许一个小数点）
        if not str(rate).replace('.', '', 1).isdigit():
            raise forms.ValidationError("仅可输入十进制数值")
        return rate

四、CurrencyCode显示为下拉框 #

这个不用额外配置！Django的ForeignKey在ModelForm里默认会渲染成下拉框（用ModelChoiceField和Select组件），你现在的代码已经满足需求。如果想自定义下拉选项的显示内容，比如显示货币代码+名称，可以在__init__里改：

def __init__(self, *args, **kwargs):
    super(ForexForm, self).__init__(*args, **kwargs)
    # ... 其他配置
    # 假设Currency模型有currency_name字段，自定义下拉选项文本
    self.fields['currency_code'].label_from_instance = lambda obj: f"{obj.currency_code} - {obj.currency_name}"

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