添加自定义User模型字段后执行makemigrations报OperationalError错误求助

针对执行python manage.py makemigrations时出现的django.db.utils.OperationalError: no such column: authentication_user.name错误，可按以下步骤排查解决：

• 确认迁移文件生成情况
  检查authentication应用的migrations目录，是否存在包含添加name字段的迁移文件。如果没有，指定应用重新生成迁移：

  python manage.py makemigrations authentication
  

  全局makemigrations有时会因应用依赖问题漏检模型变化，指定应用生成更可靠。

• 手动生成迁移（自动检测失效时）
  若自动检测未识别到name字段的添加，可创建空迁移并手动添加字段操作：

  1. 生成空迁移文件：

     python manage.py makemigrations authentication --empty
     

  2. 打开生成的迁移文件，在operations列表中添加字段定义：

     operations = [
         migrations.AddField(
             model_name='user',
             name='name',
             field=models.CharField(default='', max_length=250, blank=True, null=True),
         ),
     ]
     

• 同步数据库与迁移记录

  1. 查看authentication应用的迁移状态：

     python manage.py showmigrations authentication
     

     标记[X]的是已应用的迁移，未标记的需执行应用：

     python manage.py migrate authentication
     

  2. 若迁移记录与数据库状态不一致（如曾删除迁移文件），可在开发环境执行以下操作（需先备份数据库）：
     • 删除authentication/migrations目录下除__init__.py外的所有文件
     • 删除数据库django_migrations表中属于authentication的所有记录
     • 重新生成初始迁移并应用：

       python manage.py makemigrations authentication
       python manage.py migrate authentication
       

• 清理Django缓存
  Django可能缓存旧的模型结构，执行缓存清理并重启开发服务器：

  python manage.py clearcache
  

• 排查提前引用字段的代码
  检查信号、Admin配置、表单或其他业务代码中，是否在迁移完成前就引用了User.name字段。若有，暂时注释相关代码，完成迁移后再恢复。

• 验证数据库权限
  确保Django使用的数据库用户拥有修改表结构的权限（如MySQL的ALTER权限、PostgreSQL的ALTER TABLE权限），无权限会导致字段无法创建。

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