Django登录Admin面板触发IntegrityError唯一约束失败问题求助

问题根源 #

你重写的User.save()方法会在每次用户实例保存时（包括创建、更新，比如Admin登录时更新last_login字段）执行UserProfile.objects.create(user=self)，而OneToOne字段要求唯一关联，当Profile已存在时，重复创建就会触发UNIQUE constraint failed错误。

修复方案 #

方案1：修改save方法，避免重复创建 #

把直接创建的逻辑改成仅在新用户创建时生成Profile，或者用get_or_create确保不会重复创建：

方式A：仅在新用户创建时生成

class User(AbstractUser):
    # 你的自定义字段
    def save(self, *args, **kwargs):
        # 判断是否是新创建的用户（无主键即为新创建）
        is_new = not self.pk
        # 先调用父类save保存用户实例
        super().save(*args, **kwargs)
        # 仅新用户时创建Profile
        if is_new:
            UserProfile.objects.create(user=self)

方式B：用get_or_create兼容所有场景

如果存在Profile被意外删除的情况，用get_or_create更稳妥，它会自动判断：存在则返回已有实例，不存在则创建：

class User(AbstractUser):
    # 你的自定义字段
    def save(self, *args, **kwargs):
        super().save(*args, **kwargs)
        # get_or_create 不会触发重复创建
        UserProfile.objects.get_or_create(user=self)

方案2：改用post_save信号（推荐） #

Django的信号机制更适合这种关联实例的自动创建，避免重写save方法带来的多次触发问题：

在models.py中添加：

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

# 关联User模型的post_save信号
@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
    # 仅当用户被创建时生成Profile
    if created:
        UserProfile.objects.create(user=instance)

# 确保用户更新时，Profile也能同步保存（可选）
@receiver(post_save, sender=User)
def save_user_profile(sender, instance, **kwargs):
    instance.userprofile.save()

验证说明 #

你删除待登录用户的UserProfile后错误消失，正是因为登录时触发了User.save()（更新last_login），此时原代码会创建新的Profile（之前被删除了，所以不会冲突）；而当Profile存在时，重复创建就触发了唯一约束错误，上述方案都能解决这个问题。

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