Django报错：AUTH_USER_MODEL引用的'book.CustomUser'模型未安装

以下是针对该错误的具体解决步骤：

• 确认应用已加入INSTALLED_APPS
  打开项目根目录的settings.py，找到INSTALLED_APPS配置项，确保你的book应用已经添加进去：

  INSTALLED_APPS = [
      # 保留默认的Django应用，比如'django.contrib.admin'等
      'book',
  ]
  

• 检查CustomUser模型的正确性
  在book应用的models.py中，确保CustomUser模型定义完整且符合Django要求：

  • 如果是扩展默认用户模型，继承AbstractUser：

    from django.contrib.auth.models import AbstractUser
    from django.db import models
    
    class CustomUser(AbstractUser):
        # 可添加自定义字段，比如：
        phone = models.CharField(max_length=11, blank=True)
    

  • 如果是完全自定义用户模型，继承AbstractBaseUser的话，必须配套实现UserManager，否则会导致模型无法正常加载。

• 验证AUTH_USER_MODEL的格式
  在settings.py中，AUTH_USER_MODEL的格式必须严格为应用名.模型类名，确认配置正确：

  AUTH_USER_MODEL = 'book.CustomUser'
  

  注意检查应用名和模型类名的拼写、大小写是否与实际文件一致。

• 执行完整的数据库迁移
  这个错误常出现在未正确执行迁移的情况下，按以下步骤操作：

  1. 若项目处于开发初期，可直接删除book/migrations目录下除__init__.py外的所有文件，同时清空本地数据库。
  2. 依次执行以下命令：

     python manage.py makemigrations book
     python manage.py migrate
     

  重要提醒：Django不允许在已有auth相关迁移记录的项目中途更换用户模型，所以必须在项目首次迁移前就配置好AUTH_USER_MODEL，否则只能重置数据库。

• 规范用户模型的引用方式
  在项目其他地方引用用户模型时，必须使用Django提供的get_user_model()方法，避免直接导入：

  from django.contrib.auth import get_user_model
  
  User = get_user_model()
  

  如果是在模型中定义外键或多对多关系，需引用settings.AUTH_USER_MODEL：

  from django.conf import settings
  from django.db import models
  
  class Book(models.Model):
      owner = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
  

内容的提问来源于stack exchange，提问作者Amaldev K S