Django ModelForm验证unique together约束出现CrispyError如何解决

修复as_crispy_field报错 #

你遇到的报错根因是在校验到重复名称时，手动删除了cleaned_data中的三个表单字段，crispy表单渲染时需要读取这些字段的状态，字段不存在就会触发该错误。你完全不需要手动删除cleaned_data的字段，Django表单会自动处理校验失败后的字段回显和错误提示。

优化后的clean方法写法： #

def clean(self):
    cleaned_data = super().clean()
    objective_name = cleaned_data.get("objective_name")
    # 只有当名称字段通过基础校验、有值时才做唯一性校验
    if objective_name:
        # 用exists()比count()效率更高，不需要统计全量匹配结果
        if self.objs.filter(objective_name=objective_name).exists():
            # 将错误绑定到具体字段，crispy可以正常渲染字段错误提示
            self.add_error('objective_name', "该课程下已存在同名的学习目标")
    return cleaned_data

如果不需要自定义错误提示，你甚至可以完全不用手写clean逻辑：只要在初始化表单时，提前给实例赋值user和course字段，Django的ModelForm会自动校验模型定义的unique_together约束，代码更简洁也更不容易出错：

视图层修改：

if request.method == 'POST':
    # 提前构造实例，赋值不需要用户输入的user和course字段
    obj = Objective(user=user, course=this_course)
    form = ObjectiveForm(request.POST, instance=obj)
    if form.is_valid():
        form.save()
        # 后续逻辑保持不变

表单层修改：

可以直接删除你自定义的clean方法，以及__init__中传user、my_course的逻辑，表单会自动完成联合唯一约束校验。 #

模型层联合唯一约束必须保留 #

哪怕表单侧已经做了校验，数据库层面的unique_together约束也不能删，原因有两个：

1. 表单校验只能覆盖当前表单入口的请求，如果后续有后台操作、批量导入数据、其他接口调用等场景绕过了表单，没有数据库约束就会直接产生脏数据，破坏数据一致性
2. 数据库约束是数据安全的最后一道防线，哪怕上层代码出现bug，也能避免重复数据被写入

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