You need to enable JavaScript to run this app. 如何自定义与翻译Django PasswordChangeForm的错误提示信息
优惠活动
大模型
产品
解决方案
定价
更多

如何自定义与翻译Django PasswordChangeForm的错误提示信息

改密码表单英文错误提示的落地解决方法

你遇到的英文错误提示来自Django内置密码修改表单、密码校验逻辑的默认硬编码英文文案,不属于自定义字段配置的范畴,可通过两种方式实现中文/自定义语言的展示:

方案1:开启Django内置国际化翻译(推荐,无遗漏)

该方案直接调用Django官方维护的多语言文案包,无需逐行修改错误提示,所有内置的密码校验、表单字段错误都会自动匹配对应语言。

  • 在项目配置文件settings.py中做如下修改:
    # 替换原有语言配置
    LANGUAGE_CODE = 'zh-hans'
    USE_I18N = True
    # 在MIDDLEWARE配置列表中,确保LocaleMiddleware的位置在SessionMiddleware之后、CommonMiddleware之前
    MIDDLEWARE = [
        'django.middleware.security.SecurityMiddleware',
        'django.contrib.sessions.middleware.SessionMiddleware',
        'django.middleware.locale.LocaleMiddleware',
        'django.middleware.common.CommonMiddleware',
        # 其余原有中间件按顺序保留即可
    ]
    
    配置生效后,所有内置的表单错误(比如“原密码不正确”“两次输入密码不一致”“密码长度不足”等提示)都会自动替换为对应语言的翻译,不需要在表单里额外写自定义错误。

方案2:逐字段覆盖自定义错误文案(适合非通用语言场景)

如果不需要全局国际化,只针对当前改密码表单替换成自定义语言文案,可在原有PasswordChangingForm类中覆盖内置的校验逻辑、错误提示:

from django.contrib.auth.forms import PasswordChangeForm
from django import forms
from django.contrib.auth import password_validation

class PasswordChangingForm(PasswordChangeForm):
    old_password = forms.CharField(
        widget=forms.PasswordInput(attrs={'class': 'form-control', 'type':'password'}),
        error_messages={
            'required': '请输入原密码',
        }
    )
    new_password1 = forms.CharField(
        max_length=100, 
        widget=forms.PasswordInput(attrs={'class': 'form-control', 'type':'password'}),
        error_messages={
            'required': '请输入新密码',
        }
    )
    new_password2 = forms.CharField(
        max_length=100, 
        widget=forms.PasswordInput(attrs={'class': 'form-control', 'type':'password'}),
        error_messages={
            'required': '请再次输入新密码',
        }
    )

    # 覆盖内置的旧密码校验错误
    def clean_old_password(self):
        old_password = self.cleaned_data["old_password"]
        if not self.user.check_password(old_password):
            # 可将下方文案替换为你需要的自定义语言内容
            raise forms.ValidationError("原密码输入错误")
        return old_password

    # 覆盖内置的两次密码一致性校验、密码强度校验错误
    def clean_new_password2(self):
        password1 = self.cleaned_data.get('new_password1')
        password2 = self.cleaned_data.get('new_password2')
        if password1 and password2 and password1 != password2:
            raise forms.ValidationError("两次输入的新密码不一致")
        # 处理密码强度校验的提示替换
        try:
            password_validation.validate_password(password2, self.user)
        except forms.ValidationError:
            raise forms.ValidationError("新密码不符合格式要求")
        return password2

    class Meta:
        model = CustomUser
        fields = ('old_password','new_password1', 'new_password2')

模板侧优化提示

你当前模板中直接展示{{ form.errors }}的写法会把所有错误集中堆砌,可调整为逐字段匹配错误展示,提升页面可读性:

<!-- 把原来的{{ form.errors }}替换成每个字段下的独立错误块 -->
<div class="col-sm-8">
    {{ form.old_password }}
    {% if form.old_password.errors %}
        <div class="text-danger mt-1">{{ form.old_password.errors.0 }}</div>
    {% endif %}
</div>
<!-- 新密码、确认密码字段按上述逻辑逐一绑定对应错误展示即可 -->

内容的提问来源于stack exchange,提问作者chuluunhvv Nyamjaw

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 18:57:03