如何在Django表单clean()方法中获取清洗后数据及实现条件必填字段

嘿，我来帮你搞定这两个Django表单的常见问题，都是开发中经常碰到的场景：

当你在表单的clean()方法里，所有单个字段的独立清洗逻辑（比如clean_phone_number()这类针对单个字段的清洗方法）已经执行完毕了，所以清洗后的字段值都会存放在self.cleaned_data字典中。

不过有个小细节要注意：如果某个字段在自己的清洗方法中验证失败，它会被排除在cleaned_data之外。所以访问的时候最好用.get()方法，避免KeyError。

给你个实际的代码例子：

from django import forms

class UserProfileForm(forms.Form):
    username = forms.CharField(max_length=100)
    email = forms.EmailField()

    def clean(self):
        # 先调用父类的clean()获取基础的cleaned_data
        cleaned_data = super().clean()
        
        # 安全地获取清洗后的字段值
        username = cleaned_data.get('username')
        email = cleaned_data.get('email')

        # 这里可以做跨字段的验证逻辑
        if username and email:
            if username.lower() in email.lower():
                raise forms.ValidationError("用户名不能包含在邮箱地址中")
        
        # 一定要返回清洗后的数据
        return cleaned_data

针对这种依赖其他字段的验证逻辑，Django 2.0官方文档推荐的做法是在clean()方法中处理，这种方式比一些第三方博客的实现更贴合Django的验证流程，也更可靠。

具体思路是：

• 先把phone_type设为非必填字段（required=False）
• 在clean()方法中，判断如果phone_number有值，但phone_type为空，就给phone_type字段添加错误提示

直接上代码示例：

from django import forms

class ContactForm(forms.Form):
    phone_number = forms.CharField(required=False, label="电话号码")
    phone_type = forms.CharField(required=False, label="电话类型", choices=[('mobile', '手机'), ('landline', '固话')])

    def clean(self):
        cleaned_data = super().clean()
        phone_number = cleaned_data.get('phone_number')
        phone_type = cleaned_data.get('phone_type')

        # 条件判断：如果填了电话号码，必须选择电话类型
        if phone_number and not phone_type:
            # 把错误关联到phone_type字段，让错误提示显示在对应输入框下方
            self.add_error('phone_type', '填写电话号码时，必须选择对应的电话类型')
        
        return cleaned_data

这里用self.add_error()而不是直接抛出全局ValidationError的好处是，能把错误精准绑定到phone_type字段，用户体验更友好，也符合Django的表单错误处理规范。

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