Django迁移CharField的choices字段时数据未正常更新问题求助

开发者阿泽

2026-7-19

Django CharField Choices 修改后的数据异常问题及解决方法

问题场景

我有一个Car模型，其中包含名为color的CharField字段，可选值为white、black和blue：

class Car(models.Model):

    WHITE = "White"
    BLACK = "Black"
    BLUE = "Blue"

    COLOR_CHOICES = (
        (WHITE, "White"),
        (BLACK, "Black"),
        (BLUE, "Blue"),
    )

    ...

    color = models.CharField(max_length=20, choices=COLOR_CHOICES, default=BLUE)

已创建多个带有color值的Car对象后，我修改了choices选项（将所有BLUE替换为RED，同时把默认值改为RED），执行迁移后出现以下异常：

在Django Shell中查看原有color为BLUE的对象时，显示为已不存在的Car.BLUE；
在Django Admin中查看这些对象时，显示为Car.WHITE；
新创建对象可正常使用新默认值RED。

我的疑问：

迁移CharField的choices字段时是否遗漏了特定步骤？
该异常现象的原因是什么，如何安全修复？
是否需要手动（或通过脚本）修复数据？

原本期望执行迁移时，所有原有color为BLUE的对象会自动更新为RED，迁移过程无报错，手动修改原有对象也正常。

环境：Django 4.1.5，PostgreSQL数据库

问题解答

1. 迁移choices字段时是否遗漏步骤？

是的，你遗漏了数据迁移步骤。Django的自动迁移仅处理模型字段的结构变更（比如字段类型、长度、约束等），不会自动修改数据库中已有的数据——哪怕你修改了choices或默认值。choices本质只是给前端/后台提供可选值的提示，数据库里存储的是实际字符串值（比如"Blue"），Django不会因为choices变更就自动更新现有数据。

2. 异常现象的原因及修复方法

原因分析

Shell显示Car.BLUE：修改模型后代码里已无BLUE常量，但Django Shell会缓存之前的模型定义；同时当数据库值（"Blue"）匹配不到新的choices键时，会直接显示原始存储值，两者叠加导致显示混乱。
Admin显示为WHITE：当Django找不到choices中匹配的键时，会默认返回choices列表的第一个选项，也就是当前的WHITE，因此Admin会错误显示为白色。

安全修复步骤

临时恢复原有BLUE配置（可选但更安全）：先把模型里的BLUE常量和COLOR_CHOICES中的BLUE选项暂时加回去，避免数据显示混乱，再创建数据迁移脚本。

生成自定义数据迁移脚本：

执行命令生成空迁移文件：

python manage.py makemigrations --empty yourappname

打开生成的迁移文件，修改operations部分添加数据更新逻辑：

from django.db import migrations

def update_blue_to_red(apps, schema_editor):
    Car = apps.get_model('yourappname', 'Car')
    Car.objects.filter(color="Blue").update(color="Red")

class Migration(migrations.Migration):

    dependencies = [
        ('yourappname', '之前的迁移文件名'),
    ]

    operations = [
        migrations.RunPython(update_blue_to_red),
    ]

替换yourappname为你的应用名，之前的迁移文件名为修改choices前的最后一个迁移文件。

执行数据迁移：运行命令完成数据更新：
```
python manage.py migrate
```

最终修改模型：确认数据更新完成后，删除BLUE相关配置，保留RED设置：

class Car(models.Model):

    WHITE = "White"
    BLACK = "Black"
    RED = "Red"

    COLOR_CHOICES = (
        (WHITE, "White"),
        (BLACK, "Black"),
        (RED, "Red"),
    )

    ...

    color = models.CharField(max_length=20, choices=COLOR_CHOICES, default=RED)

再次执行python manage.py makemigrations和migrate，完成模型的最终更新。

3. 是否需要手动/脚本修复数据？

是的，必须通过数据迁移脚本修复数据。Django不会自动处理choices变更带来的数据更新，只有自定义数据迁移脚本才能安全、批量地将原有"Blue"值更新为"Red"。直接在数据库中手动修改数据虽可行，但不符合Django迁移规范，易出错。

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

Django迁移CharField的choices字段时数据未正常更新问题求助

问题场景 #

问题解答 #

1. 迁移choices字段时是否遗漏步骤？ #

2. 异常现象的原因及修复方法 #