如何在Django默认用户模型中添加新字段？遇模型引用错误求助

错误核心原因 #

报错提示fdaconfig应用不存在customuser模型，本质是Django无法识别你定义的CustomUser，常见触发场景包括应用未注册、模型引用不规范、迁移文件异常三类。

具体修复步骤 #

1. 确认应用已注册到INSTALLED_APPS #

打开settings.py，检查INSTALLED_APPS列表是否包含fdaconfig：

INSTALLED_APPS = [
    # 其他默认应用
    'fdaconfig',  # 必须存在这一行
]

如果使用AppConfig方式注册，需确保路径正确：

INSTALLED_APPS = [
    # 其他默认应用
    'fdaconfig.apps.FdaconfigConfig',
]

2. 规范模型引用方式 #

• 确认CustomUser类确实在fdaconfig/models.py中，类名拼写无大小写错误。
• 其他模型（如Dataset）引用用户模型时，必须使用以下两种正确方式之一：
  • 基于settings.AUTH_USER_MODEL引用：

    from django.conf import settings
    from django.db import models
    
    class Dataset(models.Model):
        user = models.ForeignKey(
            settings.AUTH_USER_MODEL,
            on_delete=models.CASCADE,
            related_name='datasets'
        )
    

  • 基于get_user_model()引用（仅运行时可用，不能写入迁移文件）：

    from django.contrib.auth import get_user_model
    from django.db import models
    
    User = get_user_model()
    
    class Dataset(models.Model):
        user = models.ForeignKey(
            User,
            on_delete=models.CASCADE,
            related_name='datasets'
        )
    

  禁止直接写死'fdaconfig.CustomUser'或小写的'fdaconfig.customuser'，这会导致懒加载引用失败。

3. 修复迁移文件（无需删除数据库） #

若之前生成过旧迁移文件，需重新生成正确的迁移：

• 删除fdaconfig/migrations/目录下除__init__.py外的所有旧文件。
• 重新生成迁移：

  python manage.py makemigrations fdaconfig
  

• 应用迁移（Django会保留现有数据，不会删除内容）：

  python manage.py migrate fdaconfig
  

4. 修复admin.LogEntry的用户字段引用 #

admin.LogEntry是Django自带模型，默认引用原auth.User，切换自定义用户模型后需手动更新：

1. 生成空迁移文件：

   python manage.py makemigrations --empty admin
   

2. 打开生成的迁移文件，替换内容为：

   from django.conf import settings
   from django.db import migrations, models
   
   class Migration(migrations.Migration):
   
       dependencies = [
           ('admin', '0001_initial'),
           migrations.swappable_dependency(settings.AUTH_USER_MODEL),
       ]
   
       operations = [
           migrations.AlterField(
               model_name='logentry',
               name='user',
               field=models.ForeignKey(
                   on_delete=models.CASCADE,
                   to=settings.AUTH_USER_MODEL,
                   verbose_name='user',
                   related_name='log_entries'
               ),
           ),
       ]
   

3. 应用该迁移：

   python manage.py migrate admin
   

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