Django注册时重复创建UserProfile对象及单保存失败问题

1. 重复生成UserProfile的原因：

   • 当前UserProfile使用ForeignKey关联User，这种关联允许一个用户对应多个Profile实例，若存在其他自动创建Profile的逻辑（比如未展示的post_save信号），加上手动创建就会产生重复实例；即使无自动逻辑，ForeignKey也无法从数据库层面限制重复创建。
   • 原代码中检查用户名是否被占用的逻辑有误，通过UserProfile反向查询并非准确判断方式，User表本身对username有唯一约束，应直接检查User表。

2. 单次保存报错的原因：
   报错save() prohibited to prevent data loss due to unsaved related object 'user'.是因为尝试在User实例未保存到数据库（无主键值）时，创建关联它的UserProfile，此时外键无法关联到有效对象。

1. 修改模型为一对一关联 #

将UserProfile的外键改为OneToOneField，从数据库层面强制一个用户只能对应一个Profile：

# models.py
from django.contrib.auth.models import User
from django.db import models

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)  # 替换ForeignKey为OneToOneField
    name = models.CharField(max_length=150, verbose_name='Name')
    last_name = models.CharField(max_length=150, verbose_name='Last name')

    def __str__(self):
        return f'User: {self.user}'

2. 优化注册视图逻辑 #

确保只创建一次Profile，同时修正用户名检查逻辑：

# views.py
from django.contrib.auth import login
from django.contrib import messages
from django.shortcuts import render, redirect
from django.contrib.auth.models import User
from .forms import UserRegisterForm
from .models import UserProfile

def register(request):
    if request.method == 'POST':
        form = UserRegisterForm(request.POST)
        if form.is_valid():
            username = form.cleaned_data['username']
            # 直接检查User表的用户名唯一性，符合Django默认约束
            if User.objects.filter(username=username).exists():
                messages.error(request, '该用户名已被使用，请选择其他用户名。')
                return render(request, 'service/register.html', {'form': form})
            
            # 先保存User实例（获取主键）
            user = form.save()
            # 一次性创建并保存关联的UserProfile
            UserProfile.objects.create(
                user=user,
                name=username,
                last_name=form.cleaned_data['last_name']
            )
            
            login(request, user)
            messages.success(request, '注册成功！')
            return redirect('home')
        else:
            messages.error(request, '注册失败，请检查表单输入。')
    else:
        form = UserRegisterForm()
    return render(request, 'service/register.html', {'form': form})

3. 可选：使用信号自动创建Profile（推荐） #

添加post_save信号，让User创建时自动生成对应的Profile，无需在视图中手动创建，彻底避免重复问题：

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

@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
    if created:
        UserProfile.objects.create(
            user=instance,
            name=instance.username,
            last_name=instance.last_name
        )

@receiver(post_save, sender=User)
def save_user_profile(sender, instance, **kwargs):
    instance.userprofile.save()

使用信号后，视图中只需执行user = form.save()即可，无需手动创建Profile。

• OneToOneField会在数据库层面添加唯一约束，确保一个用户只能有一个Profile实例。
• 必须先保存User实例（获取主键ID），再创建关联的UserProfile，否则会触发外键关联错误。
• 原代码中通过UserProfile反向查询用户名是否被占用的逻辑不准确，应直接检查User表的username字段。

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