Django内置User模型设email唯一后，邮箱存入last_name列异常

首先，你遇到的邮箱被错误存入last_name字段的问题，根源在于直接在表单类中修改Django内置User模型的字段元数据是一种非常错误的做法。这行代码User._meta.get_field('email')._unique = True会在应用运行时篡改模型的字段定义，干扰Django ORM的字段映射逻辑，导致表单提交时字段值被错误分配，同时还会破坏迁移系统的一致性——这也是为什么你移除代码后问题依然存在的原因。

第一步：修复当前的错误状态 #

先把系统恢复到正常运行的状态：

• 立即删除forms.py中的User._meta.get_field('email')._unique = True这行代码
• 清除Django的缓存（可以重启服务器，或者执行python manage.py clearcache）
• 检查数据库，手动修正错位的数据：把last_name列中的邮箱值移回email列
• 如果之前生成了错误的迁移文件，找到并删除这些文件，然后执行python manage.py migrate确保数据库结构和原始模型一致

第二步：正确设置email字段为唯一 #

Django官方不推荐直接修改内置User模型的字段属性，这里提供两种合规的解决方案：

方案一：自定义用户模型（推荐） #

这是Django官方最推荐的方式，灵活性更高，也能避免后续版本兼容问题：

1. 在models.py中创建自定义用户模型：

from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    # 重写email字段，设置为unique
    email = models.EmailField(
        max_length=254,
        unique=True,
        help_text='Required. Inform a valid email address.'
    )

2. 在项目的settings.py中指定自定义用户模型：

AUTH_USER_MODEL = 'accounts.CustomUser'  # 替换成你的app名称和模型名

3. 更新forms.py，使用自定义用户模型：

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

class SignUpForm(UserCreationForm):
    first_name = forms.CharField(max_length=30, required=False, help_text='Optional.')
    last_name = forms.CharField(max_length=30, required=False, help_text='Optional.')
    email = forms.EmailField(max_length=254, help_text='Required. Inform a valid email address.')

    class Meta:
        model = CustomUser
        fields = ('username', 'first_name', 'last_name', 'email', 'password1', 'password2', )

4. 更新Profile模型，关联自定义用户：

from django.db import models
from django.db.models.signals import post_save
from django.dispatch import receiver
from .models import CustomUser

class Profile(models.Model):
    user = models.OneToOneField(CustomUser, on_delete=models.CASCADE)
    email_confirmed = models.BooleanField(default=False)
    encrypted_private_key = models.CharField(max_length=500, blank=True)
    public_key = models.CharField(max_length=30, blank=True)
    salt = models.CharField(max_length=16, blank=True)

@receiver(post_save, sender=CustomUser)
def update_user_profile(sender, instance, created, **kwargs):
    if created:
        Profile.objects.create(user=instance)
    instance.profile.save()

5. 生成并执行迁移：

python manage.py makemigrations
python manage.py migrate

方案二：通过迁移文件修改内置User模型（仅适用于已上线不想重构的项目） #

如果你不想替换自定义用户模型，可以通过手动编写迁移文件来修改email字段的属性：

1. 生成一个空的迁移文件：

python manage.py makemigrations accounts --empty  # 替换accounts为你的app名

2. 打开生成的迁移文件，添加字段修改操作：

from django.db import migrations, models

class Migration(migrations.Migration):

    dependencies = [
        ('accounts', '0001_initial'),  # 替换成你app的最后一个迁移文件名
    ]

    operations = [
        migrations.AlterField(
            model_name='user',
            name='email',
            field=models.EmailField(max_length=254, unique=True, verbose_name='email address'),
        ),
    ]

3. 执行迁移：

python manage.py migrate

⚠️ 注意：这种方式修改内置模型存在风险，后续Django版本更新可能会出现兼容性问题，仅作为临时解决方案。

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