Django UserCreationForm自定义错误消息失效问题求助

问题根源 #

• UserCreationForm的密码校验（如password_too_short、password_common等）是通过clean_password1方法调用django.contrib.auth.password_validation.validate_password实现的，这类错误消息无法通过Meta类的error_messages覆盖。
• password_mismatch错误是在clean_password2方法中抛出的，同样不读取Meta类的配置。
• 用户名的unique错误属于模型字段约束，需要在Meta类的error_messages中针对username字段配置，而非单独设置非字段错误。

修正后的代码示例 #

先导入所需模块：

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth.password_validation import validate_password
from django.contrib.auth.models import User
from django import forms
from django.core.exceptions import ValidationError

然后定义自定义表单：

class UserSignUpForm(UserCreationForm):
    # 自定义字段标签与必填错误提示
    username = forms.CharField(label="自定义用户名", error_messages={'required': '请输入用户名.'})
    password1 = forms.CharField(label="自定义密码", widget=forms.PasswordInput, error_messages={'required': '请输入密码.'})
    password2 = forms.CharField(label="确认自定义密码", widget=forms.PasswordInput, error_messages={'required': '请确认密码.'})

    class Meta(UserCreationForm.Meta):
        model = User
        fields = UserCreationForm.Meta.fields
        # 处理模型层的用户名唯一错误
        error_messages = {
            'username': {
                'unique': '该用户名已被使用，请更换.',
            }
        }

    def clean_password1(self):
        password1 = self.cleaned_data.get("password1")
        # 自定义密码规则校验的错误消息
        try:
            validate_password(
                password1,
                self.user,
                error_messages={
                    'password_too_short': '密码长度不能少于8位.',
                    'password_common': '密码过于常见，请更换.',
                    'password_entirely_numeric': '密码不能全为数字.',
                }
            )
        except ValidationError as e:
            self.add_error('password1', e)
        return password1

    def clean_password2(self):
        password1 = self.cleaned_data.get("password1")
        password2 = self.cleaned_data.get("password2")
        if password1 and password2 and password1 != password2:
            # 自定义密码不匹配的错误提示
            raise ValidationError("两次输入的密码不一致，请重新输入.")
        return password2

代码说明 #

1. 用户名错误处理：在Meta类的error_messages中针对username字段设置unique错误消息，覆盖模型层的默认提示。
2. 密码规则错误：重写clean_password1方法，调用validate_password时传入自定义的error_messages参数，替换默认的密码强度提示。
3. 密码不匹配错误：重写clean_password2方法，自定义抛出ValidationError的内容，替换默认的不匹配提示。
4. 字段必填错误：在字段定义时通过error_messages设置required消息，直接覆盖默认提示。

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