Django 基于类视图（Class Based View）中表单验证功能不生效问题求助

问题原因 #

• 自定义校验方法不符合Django表单规范，且缩进错误不属于表单类
  Django Form的单字段自定义校验方法必须遵循 clean_<字段名> 的命名规则才能被自动触发，你写的validate_email、validate_age不符合命名要求。另外代码中这两个方法的缩进为顶格，属于全局函数，根本不是SignUpForm的类方法，表单校验时自然不会调用。
• 视图POST逻辑错误，丢弃了带校验错误的表单实例
  你在form.is_valid()判断为False后，重新初始化了一个空的SignUpForm实例，原来携带用户输入和错误信息的表单被替换，前端自然看不到任何报错。另外校验通过后的redirect('/signup')没有加return，跳转逻辑根本不会生效。
• email字段未配置正确类型
  你邮箱字段用的是普通CharField，本身不会触发邮箱格式校验，建议改为EmailField自动开启基础格式校验。

修复后的代码 #

1. 表单类修复 #

class SignUpForm(forms.Form):
    first_name = forms.CharField(max_length=32, required=True)
    last_name = forms.CharField(max_length=32, required=True)
    username = forms.CharField(max_length=32, required=True)
    # 改为EmailField自动做基础格式校验
    email = forms.EmailField(label="email")
    password1 = forms.CharField(label="Password", max_length=32, widget=forms.PasswordInput(attrs={'class': 'password'}))
    password2 = forms.CharField(label="Password Again", max_length=32, widget=forms.PasswordInput(attrs={'class': 'password'}))
    date_of_birth = forms.DateField(label="Date of birth", required=True, widget=forms.SelectDateWidget(years=YEARS, attrs={'class': 'date-select'}))

    # 修正为clean_字段名格式，缩进调整为类内部
    def clean_email(self):
        data = self.cleaned_data.get('email')
        if User.objects.filter(email=data).exists():
            raise forms.ValidationError("This email is already registered")
        return data

    # 年龄校验用clean_date_of_birth命名，简化年龄计算逻辑
    def clean_date_of_birth(self):
        user_date = self.cleaned_data['date_of_birth']
        today = dt.today()
        age = today.year - user_date.year - ((today.month, today.day) < (user_date.month, user_date.day))
        if age < 18:
            raise forms.ValidationError("You must be 18 years old to have an account")
        return user_date

2. 视图类修复 #

class SignUpPage(View):
    def get(self, request):
        form = SignUpForm()
        return render(request, "signup.html", {'form': form})
    def post(self, request):
        form = SignUpForm(request.POST or None)
        if form.is_valid():
            # 加return实现跳转
            return redirect('/signup')
        # 校验失败直接传原来带错误的form，不要重新初始化
        ctx = {"form": form}
        return render(request, "signup.html", ctx)

前端模板无需修改，调整后自定义校验即可正常触发。

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