Django表单ValidationError未显示问题求助

尝试在注册表单的senha2输入框下方显示错误提示，但未成功。测试时Django在if respostas_form.is_valid():判定表单无效，但预期的错误消息未显示。已使用Django的clean方法为senha2字段抛出forms.ValidationError，但无效。

问题根源分析 #

1. 视图未传递带错误的表单实例：当POST请求中表单验证失败时，视图仍将空的cadastro_form传给模板，而非带有错误信息的respostas_form
2. clean方法存在逻辑漏洞：若senha字段本身验证失败（比如格式不符合要求），self.cleaned_data.get('senha')会返回None，导致密码对比逻辑不执行，错误无法抛出
3. HTML存在冗余属性：label标签重复定义了class属性，可能导致样式或渲染异常
4. 用户唯一性校验使用redirect：redirect会丢失表单的错误信息，导致用户看不到字段级错误

解决方案 #

1. 修复视图逻辑，传递带错误的表单 #

修改views.py中的cadastrar函数，当表单验证失败时，将respostas_form传给模板：

def cadastrar(request):
    if request.user.is_authenticated:
        return redirect('inicio')

    cadastro_form = forms.CadastroForm()

    if request.method == 'POST':
        respostas_form = forms.CadastroForm(request.POST)
        cadastro_result = cadastrar_usuario(request, respostas_form)
        if cadastro_result:
            return cadastro_result
        # 表单验证失败时，将带错误的表单赋值给cadastro_form
        cadastro_form = respostas_form

    return render(request, 'usuarios/cadastrar.html', {
        "cadastro": cadastro_form,
    })

2. 完善clean_senha2方法 #

确保无论senha是否通过验证，都能正确抛出错误，同时处理senha为空的情况：

def clean_senha2(self):
    senha = self.cleaned_data.get('senha')
    senha2 = self.cleaned_data.get('senha2')

    # 先检查senha2是否存在（避免字段未填写的情况）
    if not senha2:
        raise forms.ValidationError('Confirme sua senha')
    
    # 若senha未通过验证，self.cleaned_data中不会有senha，此时直接抛出错误
    if senha != senha2:
        raise forms.ValidationError('Senhas não são iguais')
    
    return senha2

3. 修正HTML中的冗余属性 #

去掉label标签重复的class属性：

{% for field in cadastro.visible_fields %}
    <div class="inputContainer">
      <label class="forms__label" for="{{field.id_for_label}}">{{field.label}}</label>
      {{field}}
      {% for error in field.errors %}
        <div class="alert alert-danger">
            {{error}}
        </div>
      {% endfor %}
  </div>
{% endfor %}

4. 优化用户唯一性校验，避免丢失表单错误 #

修改cadastrar_usuario函数，当用户已存在时，不要redirect，而是将错误添加到表单字段，返回None让视图处理：

def cadastrar_usuario(request, respostas_form:CadastroForm):
    if respostas_form.is_valid():
        nome = respostas_form.cleaned_data['nome_de_usuario']
        email = respostas_form.cleaned_data['email']
        senha = respostas_form.cleaned_data['senha']

        if User.objects.filter(email=email).exists():
            # 将错误添加到email字段，而非使用messages
            respostas_form.add_error('email', 'Já existe um usuário cadastrado com esse email!!')
            return None

        if User.objects.filter(username=nome).exists():
            respostas_form.add_error('nome_de_usuario', 'Já existe um usuário cadastrado com esse nome!!')
            return None

        usuario = User.objects.create_user(password=senha, username=nome, email=email)
        usuario.save()

        messages.success(request, f"Olá {nome}, seu cadastro foi efetuado com sucesso!")
        return redirect('entrar')
    # 表单无效时返回None，让视图处理
    return None

关键说明 #

• 表单验证失败时，必须将带有错误信息的表单实例传递给模板，否则模板无法渲染字段错误
• clean_<field>方法中，要确保覆盖所有可能的错误场景，包括依赖字段未通过验证的情况
• 使用add_error方法可以将错误绑定到具体字段，让错误信息显示在对应输入框下方，提升用户体验

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