使用Django-Tenant-Users创建租户时触发IntegrityError：permissions_usertenantpermissions_profile_id_key唯一约束冲突

看起来你遇到的问题是在创建租户时，permissions_usertenantpermissions表的profile_id字段触发了唯一约束冲突。我来帮你一步步分析原因和解决办法：

核心问题分析 #

错误信息显示profile_id=(8)已经存在，这意味着你的代码尝试为同一个用户（SchoolUser，继承自UserProfile）创建多条UserTenantPermissions记录，而该表对profile_id单独设置了唯一约束（默认情况下，django-tenant-users的UserTenantPermissions表应该是对(profile_id, tenant_id)组合设置唯一约束，而不是单独对profile_id）。

可能的原因及解决步骤 #

1. 检查UserTenantPermissions表的唯一约束设置

首先确认数据库中permissions_usertenantpermissions表的约束是否正确：

• 登录PostgreSQL数据库，执行\d permissions_usertenantpermissions查看约束。
• 如果存在单独的profile_id唯一约束（如permissions_usertenantpermissions_profile_id_key），这很可能是错误的来源。django-tenant-users的默认设计是允许一个用户关联多个租户（通过(profile_id, tenant_id)组合唯一），而不是限制一个用户只能属于一个租户。

修复方法：
删除错误的唯一约束，添加正确的组合唯一约束：

-- 删除单独的profile_id唯一约束
ALTER TABLE permissions_usertenantpermissions DROP CONSTRAINT permissions_usertenantpermissions_profile_id_key;

-- 添加(profile_id, tenant_id)组合唯一约束
ALTER TABLE permissions_usertenantpermissions ADD CONSTRAINT unique_profile_tenant UNIQUE (profile_id, tenant_id);

2. 检查provision_tenant函数是否重复创建UserTenantPermissions记录

你代码中调用的provision_tenant函数是关键——如果这是你自定义的函数，很可能不小心重复创建了UserTenantPermissions条目：

• 比如同时调用了tenant.add_user(owner)和UserTenantPermissions.objects.create(profile=owner, tenant=tenant)，这会生成两条相同的关联记录。
• 或者函数内部存在循环、重复调用的逻辑。

修复方法：
确保provision_tenant只创建一次UserTenantPermissions记录。如果使用django-tenant-users官方的provision_tenant工具函数，它只会创建一次关联记录，无需额外操作。如果是自定义函数，参考官方实现：

from tenant_users.tenants.utils import get_tenant_model, get_tenant_domain_model
from tenant_users.permissions.models import UserTenantPermissions

def provision_tenant(tenant_name, tenant_slug, owner, is_superuser=False, is_staff=False, **tenant_extra):
    # 创建租户
    tenant = get_tenant_model()(
        name=tenant_name,
        slug=tenant_slug,
        **tenant_extra
    )
    tenant.save()

    # 创建域名
    domain = get_tenant_domain_model()(
        tenant=tenant,
        domain=f"{tenant_slug}.yourdomain.com"  # 替换为你的基础域名
    )
    domain.save()

    # 关联用户到租户（仅执行一次）
    if owner:
        UserTenantPermissions.objects.create(
            profile=owner,
            tenant=tenant,
            is_superuser=is_superuser,
            is_staff=is_staff
        )
        if not owner.is_active:
            owner.is_active = True
            owner.save()

    return tenant, domain

3. 排查是否存在自动创建UserTenantPermissions的信号

你提到已经检查过信号，但再仔细确认一下：是否有针对SchoolUser或UserProfile的post_save信号，在用户创建时自动生成UserTenantPermissions记录？如果有，这会和provision_tenant中的创建操作冲突。

修复方法：
移除或禁用该信号，确保只有provision_tenant负责创建用户与租户的关联记录。

4. 重置数据库序列（可选）

如果你之前清空过数据库但没有重置自增序列，可能会导致profile_id的序列值不连续，不过这通常不会直接引发约束冲突，但可以尝试重置来排除问题：

-- 重置SchoolUser表的自增序列
SELECT setval(pg_get_serial_sequence('shared_schooluser', 'id'), max(id)) FROM shared_schooluser;
-- 重置UserTenantPermissions表的自增序列
SELECT setval(pg_get_serial_sequence('permissions_usertenantpermissions', 'id'), max(id)) FROM permissions_usertenantpermissions;

额外优化建议 #

在你的school_login视图中，创建用户后可以简化保存逻辑，减少数据库操作：

# 原代码
user = SchoolUser.objects.create_user(
    email=email,
    password=password,
)
user.role = 'director'
user.is_verified = True
user.save()

# 优化为一次创建
user = SchoolUser.objects.create_user(
    email=email,
    password=password,
    role='director',
    is_verified=True
)

（注意：需要确保create_user方法支持传入role和is_verified参数，或者在SchoolUser的create_user方法中处理这些字段。）

内容来源于stack exchange