Django模型移除字段报错求助：makemigrations提示未知字段

我之前也踩过一模一样的坑，给你梳理几个能快速解决问题的步骤：

第一步：排查所有关联代码的残留引用 #

Django报“未知字段”的错误，大概率是除了models.py之外的代码里还在引用已删除的字段，先把这些残留找出来删掉：

• 检查admin.py：看看list_display、fields、readonly_fields这些配置项里有没有用到目标字段；
• 检查表单类（比如forms.py）：如果有自定义ModelForm，里面的fields或exclude是否还包含该字段；
• 检查序列化器（如果用了Django REST Framework）：serializers.py里的字段列表有没有残留引用；
• 检查模板文件：有没有在模板中直接调用{{ object.已删除字段名 }}；
• 甚至要检查信号、自定义管理器这类文件，有没有硬编码引用该字段的逻辑。

第二步：修复迁移系统与数据库的一致性 #

你手动删除数据库列的操作已经打破了Django迁移系统的状态一致性，得把这个缺口补上：

1. 确认models.py已经完全移除目标字段，没有任何残留；
2. 进入对应app目录下的migrations文件夹，删除除了__init__.py之外的所有迁移文件，同时删掉__pycache__目录里的所有缓存文件；
3. 重新生成初始迁移文件：

   python manage.py makemigrations
   

4. 用--fake-initial参数让Django跳过实际执行迁移，只标记该迁移已应用（因为你的数据库结构已经和模型一致了）：

   python manage.py migrate --fake-initial
   

第三步：测试环境的兜底方案 #

如果上面的步骤都没解决问题，且当前是测试环境（可以丢失数据）：

1. 备份数据库数据（可选）；
2. 删除整个数据库，重新创建空数据库；
3. 重新执行全量迁移：

   python manage.py migrate
   

关键提醒 #

以后千万别手动修改数据库表结构！Django的迁移系统就是用来自动同步模型与数据库的，手动操作只会让两者状态混乱，反而更容易引发问题。

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