Django模板未遍历表单字段时错误信息不显示的解决方法

问题现象 #

提交空表单时，模板中无法展示表单错误信息，但在视图函数里遍历字段错误时能正常看到这些错误。已按照Django文档方式单独渲染每个字段及对应错误，仍无法解决问题。

核心原因 #

视图函数存在逻辑错误：无论表单验证是否通过，都会重新创建一个空的表单实例传递给模板，导致原本包含错误信息的表单被覆盖，最终模板拿到的是没有错误的空表单。

问题代码片段：

def signup(request):
    print('1')
    if request.user.is_authenticated:
        print('2')
        if request.method=='POST':
            print('3')
            if request.POST.get('password1')==request.POST.get('password2'):
                print('4')
                fm=MyRegistrationForm(request.POST)
                for field in fm:
                    print("Field Error:", field.name,  field.errors)
                if fm.is_valid():
                    print('6')
                    fm.save()
                    messages.success(request, 'Registered successfully!!')
                # 错误点：不管表单是否有效，都重置为空表单
                fm=MyRegistrationForm()
                print('7')
                cur_user=request.user
                return render(request, 'account/signup.html', {'form':fm, 'cur_user':cur_user})
        # ...省略其他代码

修复步骤 #

将重置空表单的代码移到if fm.is_valid()代码块内部，仅当表单验证通过并保存后，才重置表单。修改后的视图函数：

def signup(request):
    print('1')
    if request.user.is_authenticated:
        print('2')
        if request.method=='POST':
            print('3')
            if request.POST.get('password1')==request.POST.get('password2'):
                print('4')
                fm=MyRegistrationForm(request.POST)
                for field in fm:
                    print("Field Error:", field.name,  field.errors)
                if fm.is_valid():
                    print('6')
                    fm.save()
                    messages.success(request, 'Registered successfully!!')
                    # 仅验证通过后才重置表单
                    fm=MyRegistrationForm()
                print('7')
                cur_user=request.user
                # 传递原表单（带错误或重置后的空表单）
                return render(request, 'account/signup.html', {'form':fm, 'cur_user':cur_user})
        else:
            fm=MyRegistrationForm()
            cur_user=request.user
            return render(request, 'account/signup.html', {'form':fm, 'cur_user':cur_user})
    else:
        return HttpResponseRedirect('/')

额外优化建议 #

• 无需手动对比password1和password2，UserCreationForm已内置密码一致性验证，移除手动判断代码，让表单自身处理即可，能利用表单内置的错误提示。
• 模板中可给错误信息添加样式提升可读性，比如：

  {% if form.username.errors %}
      <div class="text-danger">{{ form.username.errors|striptags }}</div>
  {% endif %}
  

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