Django配置AUTH_USER_MODEL引用自定义用户模型报错问题求助

我来帮你一步步排查和解决这个问题，你遇到的两个错误其实都是因为模型的引用路径和应用注册的细节没处理对：

1. 先搞清楚核心问题所在 #

Django要求AUTH_USER_MODEL必须用app_label.ModelName的格式，不能加.models；而第二个错误提示模型未安装，是因为你的CustomUser模型没有被正确注册到login应用的命名空间里——因为你把模型放在了models文件夹下，Django默认不会自动加载子文件夹里的模型。

2. 第一步：修正模型文件夹的导入结构 #

在你的Login应用（也就是project_app/login目录）下的models文件夹里，需要添加一个__init__.py文件，把CustomUser模型导入到应用的模型命名空间中：

假设你的CustomUser是定义在project_app/login/models/custom_user.py（或者其他文件名，比如user.py）里，那么在project_app/login/models/__init__.py中写入：

from .custom_user import CustomUser  # 替换成你实际定义CustomUser的文件名

这样Django在扫描login应用的模型时，就能找到CustomUser了。

3. 第二步：确认INSTALLED_APPS和应用配置 #

你的INSTALLED_APPS里写的'project_app.login'是正确的，这是应用的完整Python路径。为了确保app_label明确，建议检查project_app/login/apps.py的配置：

from django.apps import AppConfig

class LoginConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'project_app.login'  # 必须和INSTALLED_APPS里的路径一致
    label = 'login'  # 显式设置app_label为'login'，避免Django自动推导出错

4. 第三步：正确设置AUTH_USER_MODEL #

现在可以把settings.py里的AUTH_USER_MODEL改成：

AUTH_USER_MODEL = 'login.CustomUser'

重要提醒 #

如果在设置AUTH_USER_MODEL之前你已经运行过migrate命令创建了数据库表，那么需要重置数据库（删除旧的db文件，或者用dropdb命令清空），然后重新运行：

python manage.py makemigrations
python manage.py migrate

因为Django一旦初始化了认证相关的表，就无法修改AUTH_USER_MODEL的配置了。

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