Django中User模型Email字段无法显示及crispy表单报错求助

问题现象 #

• 在register.html中移除Email字段后无报错
• 直接渲染{{ form }}仅展示username、password1、password2字段，Email字段不显示
• 单独使用{{ form.email|as_crispy_field }}时触发CrispyError，提示传入无效或不存在的字段

相关代码及环境 #

models.py #

from django.contrib.auth.models import User

class Profile(models.Model):
    profile_pic = models.ImageField(null=True, blank=True, default='default.jpg')
    # FK
    user = models.ForeignKey(User,  max_length=10, on_delete=models.CASCADE, null=True)

forms.py #

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

class CreateUserForm(UserCreationForm):
    class Meta:
        model = User
        fields= ['username','email', 'password1', 'password2']

views.py（原错误代码） #

from .forms import UserCreationForm

def register(request):
    form = UserCreationForm()
    if request.method == "POST":
       form = UserCreationForm(request.POST)
       if form.is_valid():
          form.save()
          return redirect("my-login")

    context = {'form': form}

    return render(request, "register.html", context=context)

register.html #

{% load static %}
{% load crispy_forms_tags %}
.
.
.
<form action="" method="POST" autocomplete="off">
{% csrf_token %}
    {{ form.username|as_crispy_field }} 
   
    <!-- error is here -->
    {{ form.email|as_crispy_field }}
   
    {{ form.password1|as_crispy_field }}
    {{ form.password2|as_crispy_field }}
    <input type="submit" value="submit" />
</form>

依赖版本 #

• Django 4.2.10
• django-bootstrap4 24.1
• django-crispy-forms 1.14.0
• pillow 10.2.0
• wheel 0.42.0

问题原因 #

1. 表单类导入错误：views.py中导入的UserCreationForm是Django内置的表单类，而非自定义的CreateUserForm。内置的UserCreationForm默认只包含username、password1、password2三个字段，因此Email字段不会被渲染，直接调用form.email会触发字段不存在的错误。
2. forms.py漏导入基类：原代码中未导入UserCreationForm基类，属于潜在语法错误。

解决方案 #

1. 修正forms.py（补全基类导入） #

确保forms.py中导入UserCreationForm基类：

from django.contrib.auth.models import User
from django.contrib.auth.forms import UserCreationForm  # 新增导入

class CreateUserForm(UserCreationForm):
    class Meta:
        model = User
        fields= ['username','email', 'password1', 'password2']

2. 修正views.py（使用自定义表单类） #

将views.py中的导入和表单实例化改为自定义的CreateUserForm：

from .forms import CreateUserForm  # 改为导入自定义表单类

def register(request):
    form = CreateUserForm()  # 实例化自定义表单
    if request.method == "POST":
       form = CreateUserForm(request.POST)  # POST请求同样使用自定义表单
       if form.is_valid():
          form.save()
          return redirect("my-login")

    context = {'form': form}

    return render(request, "register.html", context=context)

3. 验证效果 #

修改完成后重启项目：

• 直接使用{{ form }}会显示包括Email在内的所有指定字段
• 使用{{ form.email|as_crispy_field }}可正常渲染Email字段，不再触发CrispyError

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