Django模型clean()方法未按预期触发字段ValidationError问题

我来帮你解决这个问题！大概率是你在实现clean()方法时漏掉了关键步骤，或者错误的字典格式导致字段级错误没被正确绑定到表单上。下面是完整的正确实现方案：

首先，我们需要确保模型的clean()方法遵循Django的验证流程，同时正确抛出绑定到字段的ValidationError：

from django.db import models
from django.core.exceptions import ValidationError

class CheckIn(models.Model):
    min_weeks = models.IntegerField()
    max_weeks = models.IntegerField()

    def clean(self):
        # 关键：先调用父类的clean方法，执行内置验证并初始化验证流程
        super().clean()

        # 验证min_weeks <= max_weeks的逻辑
        if self.min_weeks > self.max_weeks:
            # 用字段名作为键，把错误信息绑定到对应字段上
            raise ValidationError({
                'min_weeks': '*最小周数不能大于最大周数',
                'max_weeks': '*最大周数不能小于最小周数'
            })

1. 必须调用super().clean()：这一步会触发Django内置的字段验证（比如非空、类型检查），同时确保模型的验证上下文被正确初始化。很多人忘记这一步，导致自定义验证完全不生效。
2. 错误字典的键必须严格匹配字段名：'min_weeks'和'max_weeks'要和模型中定义的字段名完全一致，否则错误信息会显示为表单的全局错误，而不是对应字段的行内错误。

当你把这个模型用于ModelForm时，默认情况下表单会自动调用模型的clean()方法。但如果你的表单自定义了clean()方法，一定要记得调用super().clean()，否则模型的验证逻辑会被跳过：

from django import forms
from .models import CheckIn

class CheckInForm(forms.ModelForm):
    class Meta:
        model = CheckIn
        fields = ['min_weeks', 'max_weeks']

    # 如果表单需要额外的自定义验证，必须先调用父类clean方法
    def clean(self):
        cleaned_data = super().clean()
        # 这里可以添加表单级别的额外验证逻辑
        return cleaned_data

你可以在Django shell里先单独测试模型的验证是否生效：

from myapp.models import CheckIn
obj = CheckIn(min_weeks=10, max_weeks=5)
obj.clean()  # 此时应该正确抛出包含字段错误的ValidationError

如果这一步能正常抛出错误，说明模型的验证逻辑是正确的，表单端也会自动继承这个验证行为。

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