当前位置：首页 > news >正文

完整教程：Django中的clean()方法和full_clean()方法

news 2026/3/26 21:42:40

前言

clean()是Django在处理数据验证时的常用方法
本博客适合那些知道clean_<filename>方法但是不知道clean()方法的学习者
full_clean()方法用于测试clean()方法的第二种用法，算是补充

clean()

此方法有两种用法，一种用于表单验证，另一种用于模型验证

1、表单验证

在表单验证中，clean()方法用于执行表单最后的验证
他们的执行顺序是这样的
在这里插入图片描述
clean()方法是"最后一道防线"
下面来说一下用法

def clean_<filename>(self):""" 其他的验证 """return data# 与其他验证同级编写def clean(self):clean_data = super().clean()"""这里执行具体的操作"""return clean_data

此处super().clean()得到的是一个已经经过校验的字典

因为clean()方法在最后执行，所以此时得到的是已经经过了前面校验的数据

那么有人可能就会问了，此时已经经过了所有的clean_<filename>方法，那么此时的cleaned_data字典与此时的super().clean()是不是一样的，答案是一样的，他们虽然调用的方式不同，但是他们所指的内存地址是一样的

已知我们在clean_<filename>中抛出raise ValidationError("错误信息")错误信息时
可以在前端中通过ModelForm对象.字段名.errors.0来渲染错误信息
像这样：

<span style="color: red;">{{ form.password.errors.0 }}</span>

类似的当clean()方法中抛出raise ValidationError("错误信息")时可以
通过.non_field_errors获取错误信息
然后
在前端中这样渲染错误信息：

<span style="color: red;">{{ form.non_field_errors.0 }}</span>

2、模型验证

在定义模型的时候如果我们想在这个阶段进行数据的验证，那就需要使用到clean()方法的第二种用法

from datetime import date
from django.core.exceptions import ValidationError
class User(models.Model):
name = models.CharField(verbose_name="姓名",max_length=128)
age = models.IntegerField(verbose_name="年龄")
birthday = models.DateField(verbose_name="生日")
# --------- 验证区域 -------------
def clean(self):
super().clean()
if self.birthday > date.today():
raise ValidationError("生日不能大于今天")

注意在这里也要调用super().clean()这样才可以
否则字段里面的验证就不会生效(max_length=128这些字段级验证就会失效)
注意用self.字段名获取字段值

此时抛出的验证错误等同于在ModelForm里面
通过raise ValidationError("")抛出的验证错误
都可以通过.non_field_errors在前端中获取

举个例子：

def clean(self):
raise ValidationError("测试错误")

此时他创建的ModelForm在前端中可以通过

<span style="color: red;">{{ form.confirm_password.errors.0 }}</span>

来获取错误

总结一下就是在模型中的clean()方法抛出的错误的获取方式就
等同于在ModelForm中的clean()方法抛出的错误
都可以通过.non_field_errors获取

full_clean()

已知通过.save()会执行你在模型里面定义的验证规则以及在ModelForm中定义的验证规则
full_clean()方法则会只执行你在models.py中定义的相关验证

举个例子就明白了
models.py

class User(models.Model):
name = models.CharField(verbose_name="姓名",max_length=128)
age = models.IntegerField(verbose_name="年龄")
birthday = models.DateField(verbose_name="生日")
def clean(self):
super().clean()
if self.birthday > date.today():
raise ValidationError("生日不能大于今天")

编写一个测试用例

admin_test = User(name="张三",age=21,birthday='2027-1-1')
try:
admin_test.full_clean()
admin_test.save()
except ValidationError as e:
for field, errors in e.message_dict.items():
print(f"{field}: {errors}")

此时控制台打印

__all__: ['生日不能大于今天']

注意：full_clean()如果通过了就什么都不会返回
但是如果没有通过验证他就会抛出raise ValidationError

.save()方法可以用于ModelForm对象保存数据到数据库
也可以用于模型对象保存数据到数据库

user = models.User.objects.create(
username='john',
email='john@example.com',
password='password123'
)
# 等价于
user_object = User(
username='john',
email='john@example.com',
password='password123'
)
user_object.save()