Django可选字段类型校验问题：非法输入无校验提示

问题核心原因 #

• Django的IntegerField（即使设置blank=True, null=True）在遇到无法转换为整数的输入时，会自动将值转为None，且不会触发自定义校验器（因为校验器仅在清洗后的值有效时执行）
• 直接为字段添加校验器无效，因为校验器接收的是清洗后的None，而非用户原始输入值

解决方案 #

通过自定义表单的clean_<field_name>方法，直接获取用户原始输入并进行校验，跳过Django默认的非法值转None逻辑：

修改后的表单代码 #

class ConditionForm(forms.ModelForm):
    class Meta:
        model = Condition
        exclude = []

    def clean_ordering(self):
        # 获取用户原始输入（兼容Admin表单字段前缀）
        raw_input = self.data.get(self.add_prefix('ordering'), '').strip()
        if raw_input:
            try:
                # 尝试将输入转换为整数
                return int(raw_input)
            except ValueError:
                # 转换失败时抛出校验错误
                raise forms.ValidationError("该字段必须输入整数")
        # 输入为空时返回None，符合模型字段可选设置
        return None

完整Admin代码（替换原表单部分） #

class ConditionForm(forms.ModelForm):
    class Meta:
        model = Condition
        exclude = []

    def clean_ordering(self):
        raw_input = self.data.get(self.add_prefix('ordering'), '').strip()
        if raw_input:
            try:
                return int(raw_input)
            except ValueError:
                raise forms.ValidationError("该字段必须输入整数")
        return None


@admin.register(Condition)
class ConditionAdmin(admin.ModelAdmin):
    def get_related_models(self, obj):
        related_models = []
        related_fields = obj._meta.get_fields()

        for field in related_fields:
            if field.is_relation and field.one_to_many:
                related_model = field.related_model
                related_models.append(related_model._meta.object_name.lower())

        return related_models

    def has_delete_permission(self, request, obj=None):
        if obj:
            for related_model in self.get_related_models(obj):
                if getattr(obj, f"{related_model}_set").exists():
                    messages.warning(request, f"无法删除: {obj.common_name_en} - {obj.id}")
                    return False
        return super().has_delete_permission(request, obj)

    form = ConditionForm
    fields = [field.name for field in Condition._meta.fields]
    readonly_fields = ["id"]

关键说明 #

• self.add_prefix('ordering')用于兼容Admin表单的字段前缀（如编辑场景下的字段命名规则），确保能正确获取用户原始输入
• 仅当用户输入非空内容时才执行校验，空输入直接返回None，保留字段的可选性
• 该逻辑可复用至其他可选数值字段（如FloatField），只需将转换函数改为float()即可

内容的提问来源于stack exchange，提问作者Dan Jírovec