自定义Django用户模型后迁移报错(fields.E301)，求解决办法

错误原因 #

你遇到的fields.E301错误，是因为Django在迁移解析时，无法正确识别Article模型中author字段关联的自定义User模型。尽管你已经配置了AUTH_USER_MODEL并导入了自定义User，但直接导入模型的方式在迁移流程中会被解析为原始的auth.User，导致模型关联冲突。

解决方案 #

1. 修改外键引用方式（核心修复） #

将blog/models.py中的author字段改为使用**字符串引用settings.AUTH_USER_MODEL**的方式，这是Django官方推荐的自定义用户模型关联方法：

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

class Article(models.Model):
    author = models.ForeignKey(
        settings.AUTH_USER_MODEL, 
        null=True, 
        on_delete=models.SET_NULL, 
        related_name='articles', 
        verbose_name='نویسنده'
    )
    # 其他字段保持不变...

2. 处理迁移历史 #

根据你的项目阶段选择对应操作：

场景一：项目刚启动，无重要数据

• 删除所有app下migrations文件夹内除__init__.py之外的所有文件
• 删除项目根目录下的数据库文件（如db.sqlite3）
• 重新生成并应用迁移：

  python manage.py makemigrations
  python manage.py migrate
  

场景二：已有数据，需保留数据

• 找到blog应用下的迁移文件（如0001_initial.py），将其中所有涉及auth.User的引用替换为account.User
• 运行迁移命令：

  python manage.py migrate
  

注意事项 #

• 自定义用户模型后，所有与用户关联的外键、多对多字段都必须使用settings.AUTH_USER_MODEL或get_user_model()（后者适合在视图、信号等运行时场景使用，模型中优先用前者）
• 避免直接导入自定义User模型到其他app的models.py中，否则迁移时极易触发此类冲突

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