Django注册功能问题：用户数据无法保存至数据库

问题核心 #

通过表单、视图、模态框实现注册功能后，表单提交成功但用户数据未写入数据库，无法完成持久化。

关键问题分析 #

从提供的代码来看，有两个核心问题导致数据无法保存：

1. 表单字段名称不匹配 #

你的UserRegistrationForm要求的密码字段是password1和password2，但在register.html模板中，第一个密码输入框的name属性是password，而非password1：

<!-- 模板里的错误写法 -->
<input class="input" type="password" id="password" name="password">

这会导致表单验证时，password1字段为空，直接触发验证失败，form.is_valid()返回False，因此不会执行form.save()。

2. 表单未指定提交目标（action） #

当前表单没有设置action属性，默认会提交到当前页面的视图。如果你的模态框所在页面的视图不是register_view，那么表单提交后根本不会进入注册处理逻辑，自然无法保存数据。

解决方案 #

步骤1：修正模板字段名称 #

修改register.html中的密码输入框name属性，与表单类保持一致：

<form class="form" method="POST" action="{% url 'register' %}">
    {% csrf_token %}
    <label class="label" for="email">Email:</label>
    <input class="input" type="text" id="email" name="email">
    <label class="label" for="username">Username:</label>
    <input class="input" type="text" id="username" name="username">
    <label class="label" for="password1">Password:</label>
    <!-- 修正name属性为password1 -->
    <input class="input" type="password" id="password1" name="password1">
    <label class="label" for="password2">Confirm Password:</label>
    <input class="input" type="password" id="password2" name="password2">
    <button class="button" type="submit">Register</button>
</form>

步骤2：指定表单提交URL #

在表单标签中添加action属性，指向你的register_view对应的URL（假设你在urls.py中给该视图命名为register）：

<form class="form" method="POST" action="{% url 'register' %}">

同时确保urls.py中正确配置了注册视图：

# urls.py示例
from django.urls import path
from .views import register_view

urlpatterns = [
    # 其他URL配置
    path('register/', register_view, name='register'),
]

步骤3：优化视图的错误反馈 #

当前视图中print(form.errors)仅在GET请求时执行，POST请求验证失败时不会打印错误。可以调整代码，确保验证失败时也能看到错误信息：

def register_view(request):
    if request.method == 'POST':
        form = UserRegistrationForm(request.POST)
        if form.is_valid():
            form.save()
            return redirect("index")
        # 验证失败时打印错误
        print(form.errors)
    else:
        form = UserRegistrationForm()

    context = {'register_form': form}
    return render(request, 'registration/register.html', context)

也可以在模板中添加错误提示，让前端用户看到验证失败的原因：

<!-- 在register.html表单上方添加 -->
{% if register_form.errors %}
    <div class="alert alert-danger">
        {% for field in register_form %}
            {% for error in field.errors %}
                <p>{{ field.label }}: {{ error }}</p>
            {% endfor %}
        {% endfor %}
        {% for error in register_form.non_field_errors %}
            <p>{{ error }}</p>
        {% endfor %}
    </div>
{% endif %}

额外排查步骤 #

如果上述修改后仍有问题，可以按以下步骤排查：

• 检查数据库连接是否正常，确认DATABASES配置正确
• 查看Django控制台日志，是否有数据库操作相关的报错
• 在视图中添加断点，确认request.method是否为POST，以及form.is_valid()的返回值
• 检查是否有信号或中间件拦截了用户保存操作

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