Django注册模板无法显示验证错误排查及邮箱重复提示实现

我来帮你搞定这两个问题，先从第一个核心问题说起：为什么用户名重复的错误提示不出来？

一、验证错误无法显示的原因及修复 #

你当前的register.html模板里，只渲染了form.non_field_errors（全局非字段错误），但你在clean_username里抛出的是字段级别的验证错误，这类错误会绑定到username字段本身，不会出现在全局错误里。另外模板里的{% if error %}判断也没用，因为Django的CreateView会自动把验证失败的表单对象传递到模板，不需要额外的error变量。

修复步骤： #

1. 在模板的每个表单字段后，添加对应字段的错误渲染逻辑，比如给username字段加上错误提示：

<div class="form-group">
  <label class="col-form-label mt-4" for="inputDefault">Username*</label><br>
  {{form.username}}<br>
  {% if form.username.errors %}
    <div class="text-danger mt-1">
      {{ form.username.errors.0 }}
    </div>
  {% endif %}
</div>

用{{ form.username.errors.0 }}可以只显示第一条错误，避免多条错误堆叠显得杂乱。同理，给full_name、email、password字段都做同样的处理。

2. 删掉模板里多余的{% if error %}代码块，它对你的场景完全没用。

二、实现“邮箱已存在”的提示 #

要实现这个功能，只需要在RegisterForm里新增一个clean_email方法，逻辑和clean_username一致，检查邮箱是否已被注册：

修改forms.py： #

在clean_username方法下方添加：

def clean_email(self):
    email = self.cleaned_data.get('email')
    # 检查User表中是否已有该邮箱（因为你在form_valid里创建了User）
    if User.objects.filter(email=email).exists():
        raise forms.ValidationError(_('Customer with this email already exists'), code='invalid')
    # 如果你的Customer模型本身也存了邮箱，也可以同时检查Customer表
    # if Customer.objects.filter(email=email).exists():
    #     raise forms.ValidationError(_('Customer with this email already exists'), code='invalid')
    return email

然后在模板的email字段后添加错误渲染：

<div class="form-group">
  <label for="exampleInputEmail1" class="form-label mt-4 ">Email address*</label><br>
  {{form.email}}<br>
  {% if form.email.errors %}
    <div class="text-danger mt-1">
      {{ form.email.errors.0 }}
    </div>
  {% endif %}
  <small id="emailHelp" class="form-text text-muted">We'll never share your email with anyone else.</small>
</div>

额外提醒 #

• 你的form_valid逻辑没问题，但要注意：如果表单验证失败，CreateView会自动重新渲染模板并传递带错误的表单对象，不需要你额外处理跳转或错误传递。
• 可以给错误提示加个mt-1的margin类，让它和字段保持合适的间距，样式更美观。

这样修改后，用户名重复和邮箱重复的错误提示都会正常显示在对应字段的下方了。

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