Django DRF注册时创建User与Seller报UNIQUE约束失败错误求助

问题根源 #

UNIQUE constraint failed: seller_seller.user_id 错误表明你尝试为同一个User实例创建多个Seller实例，而Seller模型中user字段是OneToOneField，要求每个User只能对应一个Seller，因此触发唯一约束冲突。

可能的具体原因：

• 数据库中已存在该User对应的Seller记录（比如测试时手动创建过）；
• 项目中存在post_save信号，在User创建后自动生成Seller，导致与你手动创建的Seller重复；
• 重复提交注册请求，第一次已成功创建User和Seller，第二次请求时因特殊场景（比如User未被正确回滚）再次尝试创建Seller触发错误。

解决步骤 #

1. 排查现有数据 #

通过Django Shell检查数据库中是否存在重复关联：

# 进入Django Shell
python manage.py shell

# 执行检查代码
from django.contrib.auth.models import User
from seller.models import Seller

# 检查每个User对应的Seller数量
for user in User.objects.all():
    seller_count = Seller.objects.filter(user=user).count()
    if seller_count > 1:
        print(f"用户 {user.username}（ID: {user.id}）关联了 {seller_count} 条商家记录")

# 找出重复的user_id
from django.db.models import Count
duplicate_sellers = Seller.objects.values('user_id').annotate(count=Count('id')).filter(count__gt=1)
print("重复的user_id记录：", list(duplicate_sellers))

如果发现重复数据，手动清理多余的Seller记录（保留一条即可）。

2. 检查是否存在自动创建Seller的信号 #

查看项目中的signals.py或models.py，是否有类似以下的信号代码：

from django.db.models.signals import post_save
from django.contrib.auth.models import User
from django.dispatch import receiver
from .models import Seller

@receiver(post_save, sender=User)
def create_seller(sender, instance, created, **kwargs):
    if created:
        Seller.objects.create(user=instance)

如果存在该信号，这就是问题核心：你在序列化器中手动创建Seller的同时，信号也会自动创建，导致重复触发唯一约束。解决方法是删除该信号，或者修改信号逻辑（比如仅在没有Seller时创建）。

3. 修改序列化器代码，避免重复创建 #

更新UserSerializer的create方法，增加重复检查，并用事务确保原子性：

from django.db import transaction
from django.db.utils import IntegrityError
from rest_framework import serializers
from django.contrib.auth.models import User
from .models import Seller

class UserSerializer(serializers.ModelSerializer):
    email = serializers.EmailField(required=True)
    contact = serializers.CharField(max_length=15, required=True)
    cname = serializers.CharField(max_length=200, required=True)

    class Meta:
        model = User
        fields = ['id', 'username', 'email', 'password', 'contact', 'cname']
        extra_kwargs = {'password': {'write_only': True}}

    def create(self, validated_data):
        with transaction.atomic():
            # 创建User实例
            try:
                user = User.objects.create_user(
                    username=validated_data['username'],
                    email=validated_data['email'],
                    password=validated_data['password'],
                )
            except IntegrityError:
                raise serializers.ValidationError("用户名或邮箱已存在。")
            
            # 检查该User是否已关联Seller
            if Seller.objects.filter(user=user).exists():
                raise serializers.ValidationError("该用户已绑定商家信息。")
            
            # 创建Seller实例
            try:
                Seller.objects.create(
                    user=user,
                    seller_contact=validated_data['contact'],
                    seller_company_name=validated_data['cname'],
                    seller_email=validated_data['email'],
                )
            except IntegrityError as e:
                raise serializers.ValidationError(f"创建商家信息失败：{str(e)}")

        return user

• 使用transaction.atomic()确保User和Seller的创建是原子操作，任何一步失败都会自动回滚，无需手动删除User；
• 增加Seller存在性检查，提前避免重复创建；
• 保留具体错误信息，方便排查问题。

4. 测试验证 #

清理数据库中重复的Seller记录（如果有），然后重新测试注册接口，确认错误不再出现。

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