Django执行migrate重命名字段时遇Unknown column报错的解决请求

问题场景 #

将现有数据库接入Django，已通过inspectdb生成模型并完成初始迁移。修改模型字段名后执行migrate，报错：

django.db.utils.OperationalError: (1054, "Unknown column 'manufacturer_id ' in 'manufacturer_model'")

尽管该字段在数据库表中实际存在。

原始模型（inspectdb生成） #

class ManufacturerModel(models.Model):
    auto_manufacturer_model_name = models.CharField(max_length=255)
    year = models.PositiveSmallIntegerField()
    manufacturer_name = models.CharField(max_length=255)
    manufacturer_id = models.IntegerField(blank=True, null=True)
    manufacturer_year_id = models.IntegerField(blank=True, null=True)

    class Meta:
        db_table = 'manufacturer_model'

修改后模型 #

class ManufacturerModel(models.Model):
    auto_manufacturer_model_name = models.CharField(max_length=255)
    year = models.PositiveSmallIntegerField()
    manufacturer_name = models.CharField(max_length=255)
    manufacturr_id = models.IntegerField(blank=True, null=True)
    manufacturer_year = models.IntegerField(blank=True, null=True)

    class Meta:
        db_table = 'manufacturer_model'

问题原因 #

Django迁移系统默认不会自动识别字段重命名操作，直接修改模型字段名后生成的迁移文件，会被解析为删除原字段、添加新字段的逻辑。但由于是现有数据库，原字段实际存在，迁移执行时会因逻辑冲突报错；另外报错信息中字段名带空格，可能是迁移文件生成时的拼写异常。

解决步骤 #

1. 用指定参数生成重命名迁移 #

直接修改模型后，使用makemigrations的--rename-field参数明确告诉Django这是字段重命名操作，避免生成删除/添加的错误迁移：

# 重命名第一个字段
python manage.py makemigrations --rename-field manufacturer_model.ManufacturerModel.manufacturer_id=manufacturr_id
# 重命名第二个字段
python manage.py makemigrations --rename-field manufacturer_model.ManufacturerModel.manufacturer_year_id=manufacturer_year

2. 验证迁移文件内容 #

生成的迁移文件应包含RenameField操作，而非DeleteField和AddField，示例如下：

from django.db import migrations, models

class Migration(migrations.Migration):
    dependencies = [
        ('manufacturer_model', '0001_initial'),
    ]

    operations = [
        migrations.RenameField(
            model_name='manufacturermodel',
            old_name='manufacturer_id',
            new_name='manufacturr_id',
        ),
        migrations.RenameField(
            model_name='manufacturermodel',
            old_name='manufacturer_year_id',
            new_name='manufacturer_year',
        ),
    ]

3. 执行迁移 #

确认迁移文件正确后，执行migrate即可完成同步：

python manage.py migrate

额外提示 #

注意修改后的字段名manufacturr_id存在拼写错误（多了一个r），建议修正为正确的manufacturer_id（若为笔误），避免后续开发中出现不必要的问题。

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