Django注册视图无法将User模型保存至数据库问题排查

一、表单代码问题及修复 #

存在的问题： #

• 密码验证方法命名不符合Django表单规范：自定义的check_password不会被自动调用，导致密码一致性验证完全失效。
• 未遵循表单字段验证的标准流程。

修复后的表单代码： #

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

class UserRegistrationForm(forms.ModelForm):
    email = forms.EmailField()
    password = forms.CharField(label='Password', widget=forms.PasswordInput)
    password2 = forms.CharField(label='Confirm password', widget=forms.PasswordInput)

    class Meta:
        model = User
        fields = ['username', 'email']

    def clean_password2(self):
        # Django会自动调用clean_<字段名>方法做字段验证
        password = self.cleaned_data.get('password')
        password2 = self.cleaned_data.get('password2')
        if password and password2 and password != password2:
            raise forms.ValidationError('Passwords do not match!')
        return password2

二、视图代码问题及修复 #

存在的问题： #

• 错误将set_password方法当作属性赋值：user.set_password = ...是语法错误，需改为调用方法user.set_password(...)。
• 设置密码后未执行保存操作：缺少user.save()，导致用户数据根本无法写入数据库。
• 在用户未保存时调用authenticate：此时数据库中无该用户记录，authenticate必然返回None，无法完成自动登录。

修复后的视图代码： #

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

def register_view(request):
    if request.method == 'POST':
        register_form = UserRegistrationForm(request.POST)
        if register_form.is_valid():
            user = register_form.save(commit=False)
            # 正确调用密码设置方法
            user.set_password(register_form.cleaned_data['password'])
            # 将用户数据存入数据库
            user.save()
            # 直接用创建好的用户对象登录，无需再次验证
            login(request, user)
            return redirect('home1:index')
    else:
        register_form = UserRegistrationForm()
    return render(request, 'register.html', {'register_form': register_form})

三、模板代码问题及修复 #

存在的问题： #

• 确认密码字段的name属性错误：表单字段名为password2，但模板中写为password1，导致表单无法接收该值，验证失败。
• 未添加错误信息展示：用户无法得知注册失败的具体原因。

修复后的模板代码： #

<form class="form" method="post">
    {% csrf_token %}
    <!-- 显示表单全局错误 -->
    {% if register_form.non_field_errors %}
        <div class="error">{{ register_form.non_field_errors }}</div>
    {% endif %}
    
    <label class="label" for="email">Email:</label>
    <input class="input" type="email" id="email" name="email" value="{{ register_form.email.value|default:'' }}">
    {% if register_form.email.errors %}
        <div class="error">{{ register_form.email.errors }}</div>
    {% endif %}

    <label class="label" for="username">Username:</label>
    <input class="input" type="text" id="username" name="username" value="{{ register_form.username.value|default:'' }}">
    {% if register_form.username.errors %}
        <div class="error">{{ register_form.username.errors }}</div>
    {% endif %}

    <label class="label" for="password">Password:</label>
    <input class="input" type="password" id="password" name="password">
    {% if register_form.password.errors %}
        <div class="error">{{ register_form.password.errors }}</div>
    {% endif %}

    <label class="label" for="confirm_password">Confirm Password:</label>
    <!-- 修正name属性为password2 -->
    <input class="input" type="password" id="confirm_password" name="password2">
    {% if register_form.password2.errors %}
        <div class="error">{{ register_form.password2.errors }}</div>
    {% endif %}

    <button class="button" type="submit">Register</button>
</form>

关键修复总结 #

1. 表单：使用clean_password2方法实现密码验证，确保Django自动触发校验逻辑。
2. 视图：正确调用密码设置方法并保存用户，直接用创建好的用户对象完成登录。
3. 模板：修正字段名匹配问题，添加错误信息展示，让用户清晰得知注册失败原因。

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