Django注册报错：违反邮箱唯一约束问题求助

问题原因 #

1. 数据库存在重复邮箱记录：错误提示明确指向csscsecscs@gmail.com已存在，大概率是数据库中已有该邮箱的用户条目（可能来自测试注册、手动添加或迁移前的数据遗留）。
2. 表单未提前拦截重复提交：当前依赖数据库唯一约束抛出错误，未在表单层面做前置校验，导致用户体验差。
3. 表单配置缺失：原注册表单未包含密码输入字段（password1/password2），会导致用户无法完成注册流程；若以邮箱作为登录凭证，User模型也缺少必要配置。

解决步骤 #

1. 清理数据库中的重复邮箱记录 #

进入Docker容器内的PostgreSQL数据库，查询并处理重复条目：

• 查看运行中的PostgreSQL容器ID：

  docker ps
  

• 进入容器的PostgreSQL终端（替换<容器ID>、<数据库用户名>、<数据库名>为你的实际配置）：

  docker exec -it <容器ID> psql -U <数据库用户名> <数据库名>
  

• 查询目标邮箱的记录：

  SELECT id, email FROM users_user WHERE email = 'csscsecscs@gmail.com';
  

• 若存在记录，删除该条目（确认无重要数据后操作）：

  DELETE FROM users_user WHERE email = 'csscsecscs@gmail.com';
  

• 退出数据库终端：\q

2. 完善注册表单的校验逻辑 #

修改MyUserCreationForm，补充密码字段并添加邮箱唯一性前置校验：

from django import forms
from django.contrib.auth.forms import UserCreationForm
from rsm_app.users.models import User
from django.core.exceptions import ValidationError


class MyUserCreationForm(UserCreationForm):
    
    field_order = ['name', 'email', 'company', 'password1', 'password2']
    
    class Meta(UserCreationForm):
        model = User
        fields = ('name', 'email', 'company', 'password1', 'password2')

    def clean_email(self):
        email = self.cleaned_data.get('email')
        if User.objects.filter(email=email).exists():
            raise ValidationError("该邮箱已被注册，请使用其他邮箱")
        return email

3. 优化User模型（可选但推荐） #

如果系统使用邮箱作为登录凭证，而非默认的username，需在模型中添加配置：

from django.contrib.auth.models import AbstractUser
from django.db import models
from django.utils.translation import gettext_lazy as _

class User(AbstractUser):
    name = models.CharField(_("full name"), blank=True, max_length=255)
    email = models.EmailField(_('email address'), unique=True)
    company = models.CharField(_("company"), blank=True, max_length=30)

    # 配置邮箱为登录标识
    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = ['name']  # 注册必填的其他字段，按需调整

修改后重新生成并应用迁移：

python manage.py makemigrations
python manage.py migrate

4. 前端错误提示优化（可选） #

在模板中添加全局错误提示，提升用户体验：

<form class="signup" id="signup_form" method="post" action="{% url 'account_signup' %}">
  {% csrf_token %}
  {% if form.non_field_errors %}
    <div class="alert alert-danger">
      {{ form.non_field_errors }}
    </div>
  {% endif %}
  {{ form|crispy }}
  {% if redirect_field_value %}
    <input type="hidden" name="{{ redirect_field_name }}"
          value="{{ redirect_field_value }}"/>
  {% endif %}
  <button class="btn btn-primary" type="submit">{% trans "Sign Up" %} &raquo;</button>
</form>

内容的提问来源于stack exchange，提问作者Jabba the Hutt