Django迁移AbstractUser时遇ValueError：关联模型无法解析

1. 确认AUTH_USER_MODEL配置正确 #

在项目settings.py中，必须正确指定自定义用户模型，格式为应用名.模型类名，注意模型类名的大小写：

AUTH_USER_MODEL = 'useraccount.User'

若配置写成useraccount.user（小写u），会直接导致Django无法解析到目标模型。

2. 检查其他应用对User模型的引用 #

项目内其他应用（如blogapp、forumapp）若有外键关联用户模型，必须使用规范的引用方式：

• 方式一：通过settings.AUTH_USER_MODEL引用

from django.conf import settings
from django.db import models

class Post(models.Model):
    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)

• 方式二：通过get_user_model()动态获取

from django.contrib.auth import get_user_model
from django.db import models

User = get_user_model()

class Post(models.Model):
    author = models.ForeignKey(User, on_delete=models.CASCADE)

禁止直接硬编码auth.User或useraccount.User（自定义User模型所在应用内除外）。

3. 清理冲突的迁移文件 #

若之前已执行过迁移，旧迁移文件可能依赖默认auth.User，引发冲突：

• 删除useraccount/migrations目录下除__init__.py之外的所有文件及__pycache__文件夹
• 检查其他应用的迁移文件，若存在引用旧用户模型的内容，同步删除对应迁移文件（保留__init__.py）
• 删除项目根目录的数据库文件（如db.sqlite3）

4. 重新生成并执行迁移 #

完成上述操作后，依次执行命令：

python3 manage.py makemigrations
python3 manage.py migrate

额外注意事项 #

• 自定义User模型建议在项目初始化阶段就配置完成，中途更换用户模型极易引发大量迁移冲突，此类场景建议重置数据库或手动修正迁移文件
• 确保useraccount应用已添加到settings.py的INSTALLED_APPS列表中

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