Django中如何配置AUTH_USER_MODEL指向子目录bizusers的自定义用户模型

核心错配点 #

你目前的配置有三个关键问题，导致自定义用户模型始终无法被识别：

• 错把存放所有业务应用的容器目录apps注册到了INSTALLED_APPS里，这个目录本身不是Django应用，没有核心识别文件，注册了也不会加载
• 应用注册、AppConfig的路径没有写全，Django根本扫描不到bizusers目录下的模型
• 没有清理旧配置生成的残留文件，会持续触发识别报错

分步修复操作 #

1. 修正INSTALLED_APPS配置 #

移除不需要的顶层apps注册项，完整写入bizusers应用的全路径导入地址：

# config/settings.py
INSTALLED_APPS = [
    # 保留Django自带的核心依赖应用
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 自定义业务应用，必须写全从项目根开始的导入路径
    'apps.bizusers',
]

2. 修正bizusers应用的AppConfig配置 #

打开./apps/bizusers/apps.py，保证AppConfig的name属性为完整的应用导入路径，不要只写短应用名：

# ./apps/bizusers/apps.py
from django.apps import AppConfig

class BizusersConfig(AppConfig):
    # 必须填写完整导入路径，不能只写'bizusers'
    name = 'apps.bizusers'
    # Django 3.2+ 版本建议补充该配置避免字段类型警告
    default_auto_field = 'django.db.models.BigAutoField'
    # 可选配置：设置应用在后台的显示名称
    verbose_name = '业务用户管理'

3. 验证AUTH_USER_MODEL配置逻辑 #

之前你写的AUTH_USER_MODEL = "bizusers.User"本身格式符合Django规则：

Django的AUTH_USER_MODEL配置格式为[应用标签.模型类名]。当AppConfig的name配置为apps.bizusers时，Django会自动取路径最后一段bizusers作为默认应用标签，只要你的自定义用户模型类名就是User，放在./apps/bizusers/models.py里，该配置不需要修改。

如果后续需要自定义应用标签，只要在AppConfig里添加和配置值一致的label = "bizusers"属性即可，避免标签不匹配。

4. 清理旧配置残留，完成迁移 #

• 删除./apps/bizusers/migrations/目录下所有自动生成的迁移文件（保留__init__.py）
• 开发环境直接重置本地数据库，移除旧配置下残留的默认用户表关联记录
• 先执行配置自检，确认无路径识别报错：

python manage.py check

• 自检通过后再执行迁移生成与同步：

python manage.py makemigrations
python manage.py migrate

常见避坑提示 #

• 不要修改顶层./apps/__init__.py写手动导入逻辑，Django有成熟的应用加载机制，手动导入容易触发循环导入问题
• 不要把apps这类存放应用的公共容器目录加到INSTALLED_APPS中，这类目录没有标准应用结构，注册后也不会被识别
• AUTH_USER_MODEL必须在第一次执行数据库迁移前完成配置，一旦生成了默认auth.User的迁移记录，后续改动会触发大量外键关联报错，生产环境需要提前规划迁移方案，不要随意修改

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