Django拆分User模型至独立users应用的方法及报错解决

看起来你遇到的核心问题是多个继承AbstractUser的模型导致反向访问器冲突，以及后续UserAdmin配置的矛盾。我来一步步帮你梳理解决：

一、先搞懂报错根源 #

Django的AbstractUser自带groups和user_permissions两个多对多字段，默认的反向访问器名称（比如Group.user_set）是通用的。当你同时保留原应用的User和users应用的ExternalUser两个子类时，两个模型会争抢同一个反向访问器名称，直接触发冲突。而你用related_name='+'会直接禁用反向关系，这又和UserAdmin依赖多对多字段反向关系的逻辑矛盾，所以出现了第二个报错。

二、正确的拆分操作步骤 #

1. 设定系统默认用户模型（关键一步） #

既然要把用户模型拆分到users应用，建议直接把它设为系统的默认用户模型，从根源避免双用户模型的冲突。

• 先把users应用的模型改回直观的User（可选但更符合习惯）：

# users/models.py
from django.contrib.auth.models import AbstractUser

class User(AbstractUser):
    class Meta:
        permissions = (
            ('can_do_this', 'Permission1'),
            ('can_do_that', 'Permission2'),
            # ... 你的其他权限配置
        )

• 在项目settings.py中指定默认用户模型：

AUTH_USER_MODEL = 'users.User'

2. 清理原应用的旧User模型 #

如果还没做正式数据迁移，直接删除原应用中的User模型即可。如果已经有生产数据需要迁移，我会在后面补充迁移思路。

3. 过渡阶段的冲突解决（如果必须保留双模型） #

如果因为数据迁移需要暂时保留原应用的User模型，你需要给两个模型的groups和user_permissions字段手动设置唯一的related_name：

原应用的User模型：

from django.contrib.auth.models import AbstractUser, Group, Permission
from django.db import models

class User(AbstractUser):
    # 重新定义groups字段，设置唯一反向名称
    groups = models.ManyToManyField(
        Group,
        related_name='photogal_users',  # 用原应用名称做前缀，避免冲突
        related_query_name='photogal_user',
        blank=True,
        help_text='The groups this user belongs to.',
        verbose_name='groups',
    )
    # 重新定义user_permissions字段
    user_permissions = models.ManyToManyField(
        Permission,
        related_name='photogal_users',
        related_query_name='photogal_user',
        blank=True,
        help_text='Specific permissions for this user.',
        verbose_name='user permissions',
    )

    class Meta:
        permissions = (
            ('can_do_this', 'Permission1'),
            ('can_do_that', 'Permission2'),
            # ...
        )

users应用的User模型：

from django.contrib.auth.models import AbstractUser, Group, Permission
from django.db import models

class User(AbstractUser):
    groups = models.ManyToManyField(
        Group,
        related_name='external_users',
        related_query_name='external_user',
        blank=True,
        help_text='The groups this user belongs to.',
        verbose_name='groups',
    )
    user_permissions = models.ManyToManyField(
        Permission,
        related_name='external_users',
        related_query_name='external_user',
        blank=True,
        help_text='Specific permissions for this user.',
        verbose_name='user permissions',
    )

    class Meta:
        permissions = (
            ('can_do_this', 'Permission1'),
            ('can_do_that', 'Permission2'),
            # ...
        )

这样两个模型的反向访问器名称就不会重叠，makemigrations就能正常执行了。

三、原应用中使用新用户模型的方法 #

1. 导入新模型 #

在原应用的models.py中导入users应用的用户模型：

from users.models import User

2. 修改外键关联 #

如果原应用中有模型关联了旧的User模型，把外键指向新的User模型：

# 比如原Post模型
class Post(models.Model):
    author = models.ForeignKey(User, on_delete=models.CASCADE, related_name='posts')
    # ... 其他字段

3. 配置Admin后台 #

• 删除原应用admin.py中对旧User模型的注册代码。
• 在users应用的admin.py中注册新的User模型，搭配默认的UserAdmin：

from django.contrib.auth.admin import UserAdmin
from .models import User

admin.site.register(User, UserAdmin)

四、已有数据的迁移补充（可选） #

如果原应用的User模型已经有生产数据，需要把数据迁移到users应用的新模型：

1. 手动给users应用创建初始迁移（不要直接执行makemigrations，复制旧迁移的结构内容）。
2. 编写数据迁移脚本，将旧User表的数据复制到新的users_user表中。
3. 删除原应用中关于User模型的迁移文件，执行migrate完成迁移。

这个过程建议先在测试环境验证，避免数据丢失。

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