Django AuthenticationForm返回含__all__的异常错误字符串原因排查

你遇到的这个问题其实是Django表单处理非字段错误的常规逻辑——当登录验证失败时，AuthenticationForm会把错误归类为全局非字段错误（对应内部键名__all__），而不是绑定到username或password单个字段上，直接输出form.errors就会把这个内部键名也显示出来。

为什么会出现__all__？ #

你贴的类定义里确实没直接写__all__相关代码，但这个表单的clean()方法（Django内部实现的核心验证逻辑）在用户名密码不匹配时，会抛出一个未指定字段的ValidationError：

def clean(self):
    username = self.cleaned_data.get('username')
    password = self.cleaned_data.get('password')

    if username is not None and password:
        self.user_cache = authenticate(self.request, username=username, password=password)
        if self.user_cache is None:
            raise self.get_invalid_login_error()
        else:
            self.confirm_login_allowed(self.user_cache)

    return self.cleaned_data

这里的get_invalid_login_error()返回的ValidationError没有指定关联字段，Django就会默认把这类错误放到__all__这个全局错误集合里，而你直接输出form.errors时，会连带着这个内部键名一起展示。

怎么正确显示错误信息？ #

不要直接输出form.errors，而是用Django表单提供的non_field_errors()方法单独获取全局错误，模板可以改成这样：

<div class="error-wrapper">
    {% if form.non_field_errors %}
        <div class="errors">{{ form.non_field_errors }}</div>
    {% endif %}
</div>

如果还需要处理单个字段的错误（比如用户名格式不符合要求等场景），可以同时遍历字段单独处理：

<div class="error-wrapper">
    <!-- 显示单个字段的错误 -->
    {% for field in form %}
        {% if field.errors %}
            <div class="errors">{{ field.label }}: {{ field.errors }}</div>
        {% endif %}
    {% endfor %}
    <!-- 显示全局错误（比如密码错误、账号禁用） -->
    {% if form.non_field_errors %}
        <div class="errors">{{ form.non_field_errors }}</div>
    {% endif %}
</div>

这样就能避免显示__all__这个奇怪的字符串，只输出你在error_messages里定义的友好提示文本了。

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