Django设置EmailField unique=False仍报email字段UNIQUE约束失败错误

两个核心问题共同导致这个报错：

• 数据库结构未和模型定义同步。Django内置AbstractUser的email字段初始默认配置为unique=True，如果你是第一次生成用户表迁移文件之后，才修改模型给email加上unique=False，且没有重新生成、应用迁移，数据库层面的email字段唯一索引会一直保留，模型层的配置不会自动同步到库表。
• Django Admin默认新增用户表单的空值逻辑和模型配置不匹配。你给email字段设置了null=True，数据库层面允许多个NULL值存在（NULL不参与唯一约束校验），但Admin默认使用的UserCreationForm对未填写的EmailField不会存入NULL，而是存入空字符串''。空字符串是普通字符串值，只要库表存在唯一约束，重复写入空字符串就会触发冲突。

这个逻辑也能对应你观察到的现象：自定义signup表单要么强制要求填写email不会传入空值，要么你手动处理过空值转None的逻辑，所以注册流程正常；修改用户时不会重复写入空字符串email，因此编辑功能也能正常运行。

1. 同步数据库结构
   执行迁移命令，确保数据库层面对应移除email字段的唯一约束：

   python manage.py makemigrations
   python manage.py migrate
   

   执行后可以检查生成的迁移文件，确认包含如下AlterField操作，确保唯一约束确实被移除：

   migrations.AlterField(
       model_name='user',
       name='email',
       field=models.EmailField(blank=True, max_length=254, null=True, unique=False),
   ),
   

2. 自定义Admin用户新增表单，修正空值处理
   打开对应app的admin.py，继承默认的UserCreationForm重写save逻辑，把空字符串的email转为None，同时自定义UserAdmin指定使用新表单，参考代码：

   from django.contrib import admin
   from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
   from django.contrib.auth.forms import UserCreationForm
   from .models import User
   
   class CustomUserAddForm(UserCreationForm):
       class Meta(UserCreationForm.Meta):
           model = User
           fields = ("username", "rollno")
       
       def save(self, commit=True):
           user = super().save(commit=False)
           if not user.email:
               user.email = None
           if commit:
               user.save()
           return user
   
   class CustomUserAdmin(BaseUserAdmin):
       add_form = CustomUserAddForm
       # 可根据自身需求在这里配置add_fieldsets、fieldsets调整后台展示的字段
   
   admin.site.register(User, CustomUserAdmin)
   

3. 清理历史脏数据
   如果之前运行过程中已经有用户的email字段被存为空字符串，进入Django shell批量修正这部分数据，避免历史数据触发冲突：

   python manage.py shell
   

   在shell交互环境执行：

   from Accounts.models import User
   User.objects.filter(email="").update(email=None)
   

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