修改Django模型结构后出现1054未知列错误的求助

错误根源 #

你直接删除0001_initial.py迁移文件的操作是核心问题。Django的迁移系统依赖完整的迁移历史来追踪数据库结构变化，删除初始迁移后，Django会误判为全新模型，生成的新迁移不会修改已存在的cats_cat表字段，导致数据库仍保留旧字段weight、food，但模型已改为age、colour，两者不匹配，因此模板渲染时触发“未知列cats_cat.age”错误。

解决方案 #

场景1：数据库数据可丢弃（测试环境） #

1. 恢复初始迁移文件：若已备份直接恢复；未备份则先将模型改回weight、food，执行makemigrations重新生成初始迁移，再改回age、colour。
2. 清空数据库（或直接删除cats_cat表）。
3. 重新执行命令：

   python manage.py makemigrations
   python manage.py migrate
   

4. 修改模板cat_list.html，将{{ cat.weight }}改为{{ cat.age }}，{{ cat.food }}改为{{ cat.colour }}。

场景2：数据库数据需保留（生产环境） #

需通过分步迁移完成字段重命名，避免数据丢失：

1. 恢复初始迁移文件，确保迁移历史完整。
2. 添加新字段：修改Cat模型，暂时保留旧字段并新增新字段：

   class Cat(models.Model):
       nickname = models.CharField(
               max_length=200,
               validators=[MinLengthValidator(2, "Nickname must be greater than 1 character")]
       )
       # 保留旧字段
       weight = models.FloatField()
       food = models.CharField(max_length=300)
       # 新增新字段，允许空值用于后续数据迁移
       age = models.FloatField(null=True)
       colour = models.CharField(max_length=300, null=True)
       breed = models.ForeignKey('Breed', on_delete=models.CASCADE, null=False)
   
       def __str__(self):
           return self.nickname
   

   执行命令生成并应用迁移：

   python manage.py makemigrations
   python manage.py migrate
   

3. 数据迁移：生成空迁移脚本并编写数据复制逻辑：
   • 生成空迁移：

     python manage.py makemigrations cats --empty
     

   • 编辑生成的空迁移文件（文件名类似0002_auto_xxxxxx_xxxx.py）：

     from django.db import migrations
     
     def copy_cat_data(apps, schema_editor):
         Cat = apps.get_model('cats', 'Cat')
         for cat in Cat.objects.all():
             cat.age = cat.weight
             cat.colour = cat.food
             cat.save()
     
     class Migration(migrations.Migration):
         dependencies = [
             ('cats', '0002_auto_xxxxxx_xxxx'),  # 替换为实际生成的迁移文件名
         ]
     
         operations = [
             migrations.RunPython(copy_cat_data),
         ]
     

   • 执行迁移完成数据复制：

     python manage.py migrate
     

4. 删除旧字段：修改Cat模型，删除weight和food字段，执行命令完成迁移：

   python manage.py makemigrations
   python manage.py migrate
   

5. 修改模板cat_list.html，替换字段引用：将{{ cat.weight }}改为{{ cat.age }}，{{ cat.food }}改为{{ cat.colour }}。

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