Django模型校验：应重写clean还是validate_unique？二者差异解析

你的需求说明 #

确保同一开发者无法提交同名的key，不同开发者可使用同名key，且已通过模型Meta类的unique_together完成数据库层面的约束。

两种方法的代码示例 #

方法一：重写validate_unique #

def validate_unique(self, exclude=None):
    qs = KeyDefinition.objects.filter(key_name=self.key_name, developer_email=self.developer_email)
    print(qs)
    if qs:
        raise ValidationError (
             {'key_name' : ['This Key Name already exists']} 
        )
    return super().validate_unique(exclude)

方法二：重写clean #

def clean(self):
    qs = KeyDefinition.objects.filter(key_name=self.key_name, developer_email=self.developer_email)
    print(qs)
    if qs:
        raise ValidationError (
             {'key_name' : ['This Key Name already exists']} 
        )

二者的核心区别 #

1. 定位与触发时机 #

• validate_unique：Django专门为唯一性校验设计的方法，仅在模型的唯一性验证流程中触发（比如调用full_clean()的validate_unique阶段、admin后台保存时的唯一性检查），职责单一。
• clean：模型的通用数据清理方法，执行时机在字段验证之后、保存之前，可用于字段格式化、多字段逻辑校验等多种场景，不是专门的唯一性校验入口。

2. 内置逻辑集成 #

• validate_unique：调用父类方法会自动触发Django内置的唯一性校验，包括你在unique_together中定义的约束，相当于和数据库层面的约束形成双重校验。
• clean：不会自动触发内置的唯一性校验，所有逻辑需要手动实现，包括处理更新时排除当前实例这类细节。

3. 实例更新时的处理 #

你当前的两个方法都有个严重问题：更新已有实例时，filter会把当前实例本身查出来，导致误报“已存在”。而validate_unique的exclude参数就是用来处理这种场景的，父类方法会自动排除当前实例；但clean没有这种内置逻辑，需要手动加qs = qs.exclude(pk=self.pk)来避免误判。

选择建议 #

优先选择修正后的validate_unique方法，原因如下：

1. 贴合需求场景：它是专门的唯一性校验入口，职责清晰，符合Django的设计规范。
2. 内置逻辑省心：父类方法会自动处理更新时排除自身、集成unique_together校验等细节，不用自己重复造轮子。
3. 错误语义准确：抛出的错误会被归类为唯一性冲突，在admin等场景下展示更合理。

甚至你可以不用自己重写validate_unique——因为unique_together已经会自动触发内置的唯一性校验，只是错误提示是默认的。如果要自定义错误提示，更简洁的方式是修改模型字段的error_messages，或者在validate_unique中捕获内置错误并替换提示：

def validate_unique(self, exclude=None):
    try:
        super().validate_unique(exclude)
    except ValidationError as e:
        # 替换自定义错误信息
        if 'key_name' in e.message_dict or '__all__' in e.message_dict:
            e.message_dict['key_name'] = ['This Key Name already exists']
        raise e

如果一定要自己实现查询逻辑，记得加上排除当前实例的处理：

def validate_unique(self, exclude=None):
    qs = KeyDefinition.objects.filter(key_name=self.key_name, developer_email=self.developer_email)
    # 更新时排除自身
    if self.pk is not None:
        qs = qs.exclude(pk=self.pk)
    if qs.exists():
        raise ValidationError({'key_name': ['This Key Name already exists']})
    return super().validate_unique(exclude)

而clean方法更适合处理非唯一性的通用校验，比如字段格式转换、多字段间的逻辑依赖（比如起始时间小于结束时间），不建议用来做唯一性校验，容易混淆职责且手动处理细节容易出错。

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