NON_FIELD_ERRORS_KEY和表单验证错误处理的常见问题

NON_FIELD_ERRORS_KEY是Django中一个特殊的错误键，用于存储表单验证过程中与所有字段无关的错误。在表单验证过程中，如果发生与特定字段无关的错误，可以将这些错误添加到NON_FIELD_ERRORS_KEY键中，以便进行错误处理。

下面是一些常见的问题和使用例子：

1. 表单验证错误和非表单验证错误的区别：

- 表单验证错误通常与特定字段相关，例如输入数据不满足字段的验证规则。这些错误将存储在表单的字段错误集合中，可以通过字段名称访问。

- 非表单验证错误与特定字段无关，例如数据库连接错误或其他全局错误。这些错误将存储在NON_FIELD_ERRORS_KEY键中，可以通过该键访问。

2. 使用NON_FIELD_ERRORS_KEY处理全局错误：

以下是一个示例，其中包括一个表单和一个处理器函数，用于验证用户名和密码是否匹配。如果验证失败，则使用NON_FIELD_ERRORS_KEY处理非表单验证错误。

   # forms.py
   from django import forms

   class LoginForm(forms.Form):
       username = forms.CharField()
       password = forms.CharField(widget=forms.PasswordInput())

   # views.py
   from django.shortcuts import render
   from django.contrib import messages
   from .forms import LoginForm

   def login(request):
       if request.method == 'POST':
           form = LoginForm(request.POST)
           if form.is_valid():
               username = form.cleaned_data['username']
               password = form.cleaned_data['password']
               if username == 'admin' and password == 'password':
                   # 登录成功
                   return render(request, 'success.html')
               else:
                   # 非表单验证错误，用户名密码不匹配
                   messages.error(request, '用户名和密码不匹配', extra_tags='non_field_errors')
        else:
           form = LoginForm()
       return render(request, 'login.html', {'form': form})
   

以上代码中，如果用户名和密码不匹配，messages.error()函数将以non_field_errors标签将错误添加到NON_FIELD_ERRORS_KEY键中。在模板中，我们可以使用以下代码来显示非表单验证错误：

   {# login.html #}
   {% if form.non_field_errors %}
       <ul class="errorlist">
       {% for error in form.non_field_errors %}
           <li>{{ error }}</li>
       {% endfor %}
       </ul>
   {% endif %}
   

3. 使用NON_FIELD_ERRORS_KEY处理全局错误和字段错误：

可以同时在表单的字段错误和NON_FIELD_ERRORS_KEY中添加错误，以进行全局错误和字段错误的处理。例如，以下示例中，表单验证失败时，如果字段username未填写，将在表单字段错误集合中添加一个错误，同时在NON_FIELD_ERRORS_KEY中添加一个全局错误。

   # forms.py
   from django import forms

   class ExampleForm(forms.Form):
       username = forms.CharField()
       password = forms.CharField(widget=forms.PasswordInput())

   # views.py
   from django.shortcuts import render
   from django.contrib import messages
   from .forms import ExampleForm

   def example(request):
       if request.method == 'POST':
           form = ExampleForm(request.POST)
           if form.is_valid():
               # 表单验证成功
               return render(request, 'success.html')
           else:
               # 在字段错误集合中添加一个错误
               form.add_error('username', '请输入用户名')
               # 在NON_FIELD_ERRORS_KEY中添加一个错误
               form.add_error(NON_FIELD_ERRORS_KEY, '表单验证失败，请检查输入')
       else:
           form = ExampleForm()
       return render(request, 'example.html', {'form': form})
   

在上述示例中，如果字段验证失败，form.add_error()函数将在表单字段错误集合中添加一个错误。如果表单验证失败（例如，用户名和密码未填写），form.add_error()将在NON_FIELD_ERRORS_KEY键中添加一个全局错误。在模板中，我们可以使用以下代码来显示全局错误和字段错误：

   {# example.html #}
   {% if form.non_field_errors %}
       <ul class="errorlist">
       {% for error in form.non_field_errors %}
           <li>{{ error }}</li>
       {% endfor %}
       </ul>
   {% endif %}

   {% if form.username.errors %}
       <ul class="errorlist">
       {% for error in form.username.errors %}
           <li>{{ error }}</li>
       {% endfor %}
       </ul>
   {% endif %}
   

总结：

NON_FIELD_ERRORS_KEY是Django中用于存储与所有字段无关的错误的特殊错误键。可以使用它来处理全局错误，例如数据库连接错误或其他与特定字段无关的错误。可以将非表单验证错误添加到NON_FIELD_ERRORS_KEY中，并在模板中使用它来显示全局错误。同时，还可以在处理表单验证时，在字段错误集合和NON_FIELD_ERRORS_KEY中添加错误。使用NON_FIELD_ERRORS_KEY可以提高对表单验证错误的处理和错误信息的显示。