Django注册：重复账号/邮箱提示错误且新用户无法入库的问题

问题根源分析 #

你遇到的两个问题由三个关键错误导致：

1. 表单验证方法未返回字段值，导致表单无法通过验证、数据无法存入数据库
2. 表单初始化方法缩进错误，被嵌套在Meta类内部，无法正常执行
3. HTML模板中用户名的错误提示绑定到了邮箱字段，导致错误显示异常

修复后的代码 #

1. forms.py 修复 #

from django import forms
from django.contrib.auth.models import User
from django.contrib.auth.forms import UserCreationForm

class RegisterUserForms(UserCreationForm):
    class Meta:
        model = User
        fields = ['username','email','password1','password2']
        widgets = {
            'email':forms.EmailInput(attrs = {
                'required' : True,
                'placeholder' : 'Email@example.com',
                'autofocus' : True,
                'name':'email',
            }),
            
            'username':forms.TextInput(attrs = {
                'required' : True,
            })
        }
    
    # 将__init__移到Meta类外部，确保初始化逻辑生效
    def __init__(self, *args, **kwargs):
        super(RegisterUserForms, self).__init__(*args, **kwargs)
        self.fields['password1'].widget.attrs={'placeholder': 'Password from numbers and letters of the Latin alphabet'}
        self.fields['password2'].widget.attrs={'placeholder': 'Password confirmation'}

    def clean_username(self):
        username_input = self.cleaned_data.get('username')
        if User.objects.filter(username=username_input).exists():
            raise forms.ValidationError("username already exists!")
        # 必须返回验证后的字段值，否则表单验证失败
        return username_input

    def clean_email(self):
        email_input = self.cleaned_data.get('email')
        if User.objects.filter(email=email_input).exists():
            raise forms.ValidationError("email already exists!")
        # 必须返回验证后的字段值，否则表单验证失败
        return email_input

2. register.html 修复 #

<body>
    <div class="page register-page form" style="text-align: right;" >
        <h2 class="title">register</h2> 
        <form method="POST" class="register-form">
            {% csrf_token %}
            <div class="fieldWraber">
                <label for="{{form.email.id_for_label}}"> Email : </label>
                {{form.email}}
                <span class="error">{{form.email.errors}}</span>
            </div>

            <div class="fieldWraber">
                <label for="{{form.username.id_for_label}}"> Username </label>
                {{form.username}}
                <!-- 修正错误绑定：改为显示用户名的错误信息 -->
                <span class="error">{{form.username.errors}}</span>
            </div>

            <div class="fieldWraber">
                <label for="{{form.password1.id_for_label}}">password</label>
                {{form.password1}}
                <!-- 新增密码验证错误提示 -->
                <span class="error">{{form.password1.errors}}</span>
            </div>
            
            <div class="fieldWraber">
                <label for="{{form.password2.id_for_label}}">confirm password</label>
                {{form.password2}}
                <!-- 新增确认密码错误提示 -->
                <span class="error">{{form.password2.errors}}</span>
            </div>

            <input type="submit" value="register" class="submit-button">
        </form>
    </div>
</body>

3. views.py 优化 #

from django.shortcuts import render, redirect
from django.contrib.auth import login
from .forms import RegisterUserForms

def registerpage(request):
    form = RegisterUserForms()

    if request.method == 'POST':
        form = RegisterUserForms(request.POST)
        if form.is_valid():
            user = form.save()
            login(request, user)
            # 注册成功后跳转至主页（替换为你的实际URL名称）
            return redirect('home')
    
    context = {'form': form}
    return render(request, 'user/register.html', context)

修复效果 #

• 重复用户名/邮箱时，对应字段下方会显示正确的错误提示
• 新用户填写合法信息后，数据会正常存入数据库，自动登录后跳转至指定页面

内容的提问来源于stack exchange，提问作者Reham.Dev