Django Forms应用两个字段验证时触发KeyError('end')报错

Django表单的校验执行有固定规则：

1. 字段级clean_<字段名>方法会按照表单中字段定义的顺序依次执行，只要某字段的校验（包括默认格式校验、自定义clean_<字段名>逻辑）抛出ValidationError，该字段就不会被加入self.cleaned_data字典。
2. 你当前把跨字段的校验逻辑写在了单字段的clean方法中，且直接用[]语法从cleaned_data硬取键值：
   • 当clean_end触发校验报错时，end字段不会被写入cleaned_data
   • 后续按顺序执行clean_active方法时，直接访问self.cleaned_data['end']就会触发KeyError
3. 单独启用某一个校验方法时不会触发跨方法的字段缺失问题，因此可以正常运行。

另外你在clean_end中直接取self.cleaned_data['start']也存在同样风险：如果start字段自身校验失败，同样会触发KeyError。

1. 所有涉及多个字段的交叉校验逻辑，不要写在单字段clean方法中，统一放到表单的全局clean()方法中，该方法会在所有单字段校验完成后执行，是Django官方推荐的跨字段校验位置。
2. 从cleaned_data中取值时使用.get()方法，避免字段校验失败不存在时触发KeyError；跨字段报错用self.add_error()绑定到对应字段上，不影响表单错误展示。

修正后的校验代码示例：

def clean(self):
    cleaned_data = super().clean()
    start = cleaned_data.get("start")
    end = cleaned_data.get("end")
    active = cleaned_data.get("active")

    # 校验结束日期不得早于开始日期
    if start and end and end < start:
        self.add_error(
            "end",
            forms.ValidationError("end date cannot be less than start date.")
        )

    # 校验在职状态员工不应设置结束日期
    if active and end:
        self.add_error(
            "end",
            forms.ValidationError("active employee should not have an end date set.")
        )

    return cleaned_data

写完后直接删掉原来的clean_end、clean_active两个方法即可，原有校验逻辑的提示效果和之前完全一致。

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