Django 1.11：与User模型一对一关联的Profile重复生成实例问题

这种一个用户对应两个Profile的问题我之前碰到过好几次，大概率是信号注册重复或者触发时机不对导致的，咱们一步步来排查和解决：

1. 先给信号加上唯一标识，避免重复注册 #

Django里如果信号没指定dispatch_uid，当模块被重复导入（比如不同文件多次import你的models），信号就会被注册多次，每次用户创建都会触发多轮信号，进而生成多个Profile。

修改你的信号代码，加上唯一的dispatch_uid参数：

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

@receiver(post_save, sender=User, dispatch_uid='appname_create_user_profile')
def create_user_profile(sender, instance, created, **kwargs):
    # 只在用户首次创建时生成Profile
    if created:
        Profile.objects.create(user=instance)

dispatch_uid的值只要在项目里唯一就行，比如用「你的app名+功能描述」的格式，确保信号只会被注册一次。

2. 用get_or_create代替create做兜底 #

就算信号不小心触发多次，get_or_create会先检查该用户的Profile是否存在，不存在才创建，从根源避免重复生成：

@receiver(post_save, sender=User, dispatch_uid='appname_create_user_profile')
def create_user_profile(sender, instance, created, **kwargs):
    if created:
        # 用get_or_create确保一个用户只会有一个Profile
        Profile.objects.get_or_create(user=instance)

3. 确认Profile模型的关联字段类型 #

一定要保证Profile里和User的关联字段是OneToOneField而不是ForeignKey——ForeignKey默认允许多个实例关联同一个User，这会直接导致重复生成：

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

class Profile(models.Model):
    # 必须用OneToOneField，强制一对一关联约束
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    # 你的其他字段，比如头像、简介等

4. 排查是否有其他代码在创建Profile #

仔细检查项目里所有涉及Profile创建的逻辑：

• 有没有在User模型的save方法里手动创建Profile？
• 有没有其他信号也监听了User.post_save事件？
• 有没有第三方库（比如django-allauth）在用户创建流程中额外触发了save操作？

如果有多个地方都在创建Profile，自然会出现重复实例。

5. 加日志定位触发次数（临时排查用） #

如果还是找不到问题，可以在信号函数里加日志，直观看到信号触发次数和Profile创建情况：

import logging
logger = logging.getLogger(__name__)

@receiver(post_save, sender=User, dispatch_uid='appname_create_user_profile')
def create_user_profile(sender, instance, created, **kwargs):
    logger.debug(f"Profile信号触发：created={created}，用户ID={instance.id}")
    if created:
        profile, is_created = Profile.objects.get_or_create(user=instance)
        logger.debug(f"Profile实例：ID={profile.id}，是否新建={is_created}")

创建用户后查看日志，就能清楚知道信号到底触发了几次，以及Profile是否重复创建。

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