Django表单clean方法无法读取start_date字段的原因

核心原因 #

出现KeyError: 'start_date'的主要问题是自定义的clean方法未调用父类的clean方法，且直接通过键名访问cleaned_data未做存在性判断。

Django表单的清洗流程是：先执行各字段的clean_<field>方法（比如你的clean_start_date），再执行表单级的clean方法。父类（ModelForm）的clean方法会负责整合所有字段级清洗后的有效数据到cleaned_data，还会处理必填字段校验等默认逻辑。如果不调用super().clean()，cleaned_data可能是不完整的，甚至没有包含经过验证的字段值，直接用cleaned_data["start_date"]就会抛出KeyError。

另外，即便你输入的start_date符合要求，若字段本身存在隐性验证失败（比如日期格式错误、字段未填写但模型中是必填项），也会导致该字段不会被加入cleaned_data，此时直接访问键名也会出错。

修复代码 #

修改clean方法，先调用父类清洗逻辑，再安全获取字段值进行验证：

class EventForm(forms.ModelForm):
    class Meta:
        model = Event
        fields = ["name", "start_date", "end_date"]

    def clean(self):
        # 必须先调用父类clean，获取完整的清洗后数据
        cleaned_data = super().clean()
        # 使用get方法安全获取字段，避免KeyError
        start_date = cleaned_data.get("start_date")
        end_date = cleaned_data.get("end_date")
        
        # 仅当两个字段都有效时才进行日期比较验证
        if start_date and end_date:
            if start_date > end_date:
                raise ValidationError("Start Date cannot be greater than End Date")
            elif start_date == end_date:
                raise ValidationError("The dates must be different.")
        # 返回清洗后的数据
        return cleaned_data

    def clean_start_date(self):
        start_date = self.cleaned_data["start_date"]
        if timezone.now() > start_date:
            raise ValidationError("The start date of the event must be after today.")
        return start_date

额外注意事项 #

• 确保Event模型中的start_date和end_date字段类型正确（比如models.DateField或models.DateTimeField），且表单提交的日期格式符合Django默认解析规则。
• 如果字段是必填项，模型中要设置blank=False，Django会自动校验，无需额外编写逻辑。

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