Django替换默认User模型报错求助：配置与反向访问器冲突

问题1：配置AUTH_USER_MODEL = 'tools.User'后提示模型未安装 #

错误信息：

django.core.exceptions.ImproperlyConfigured: AUTH_USER_MODEL refers to model 'tools.User' that has not been installed

原因分析 #

自定义User模型放在tools/models子目录下，但该子目录的__init__.py未导出User类，导致Django扫描应用模型时无法识别到这个模型。

解决步骤 #

1. 编辑tools/models/__init__.py，添加导入语句：

from .models import User, UserAdmin

2. 确认INSTALLED_APPS中已包含'tools'（你的配置已满足此条件）。
3. 执行python manage.py check验证配置，无报错后再进行迁移操作。

问题2：注释AUTH_USER_MODEL后迁移时出现反向访问器冲突 #

错误信息：

SystemCheckError: System check identified some issues:

ERRORS:
auth.User.groups: (fields.E304) Reverse accessor 'Group.user_set' for 'auth.User.groups' clashes with reverse accessor for 'tools.User.groups'.
        HINT: Add or change a related_name argument to the definition for 'auth.User.groups' or 'tools.User.groups'.
auth.User.user_permissions: (fields.E304) Reverse accessor 'Permission.user_set' for 'auth.User.user_permissions' clashes with reverse accessor for 'tools.User.user_permissions'.
        HINT: Add or change a related_name argument to the definition for 'auth.User.user_permissions' or 'tools.User.user_permissions'.
tools.User.groups: (fields.E304) Reverse accessor 'Group.user_set' for 'tools.User.groups' clashes with reverse accessor for 'auth.User.groups'.
        HINT: Add or change a related_name argument to the definition for 'tools.User.groups' or 'auth.User.groups'.
tools.User.user_permissions: (fields.E304) Reverse accessor 'Permission.user_set' for 'tools.User.user_permissions' clashes with reverse accessor for 'auth.User.user_permissions'.
        HINT: Add or change a related_name argument to the definition for 'tools.User.user_permissions' or 'auth.User.user_permissions'.

原因分析 #

未配置AUTH_USER_MODEL时，Django会同时加载默认auth.User和自定义tools.User，两者均继承PermissionsMixin，该混入类自动添加的groups和user_permissions字段，反向关联名称默认都是user_set，因此产生命名冲突。

解决步骤 #

核心要求是必须保留AUTH_USER_MODEL配置，替换默认User模型的本质就是让Django使用自定义模型，而非同时保留两个模型。结合问题1的修复，完成以下操作：

1. 确保settings.py中保留AUTH_USER_MODEL = 'tools.User'，且问题1已修复。
2. 清理无效迁移：删除tools/migrations目录下除__init__.py外的所有文件，同时删除数据库django_migrations表中属于tools应用的记录（若存在错误迁移历史）。
3. 执行迁移命令：

python manage.py makemigrations
python manage.py migrate

自定义User模型优化建议 #

1. 移除重复的password字段：AbstractBaseUser已内置password字段，无需在自定义模型中重复定义，否则会导致字段冲突和密码验证逻辑混乱。
2. 修正set_password方法：推荐使用Django内置的密码哈希逻辑，而非手动处理：

def set_password(self, raw_password):
    super().set_password(raw_password)

3. 主键字段优化：若user_id无需手动赋值，改为自增字段更便捷：

user_id = models.BigAutoField(primary_key=True)

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