如何在Django模型中不丢失现有数据将CharField改为列表/数组字段

模型层字段替换 #

根据所用数据库类型选择适配的存储字段，直接替换原有device_id定义：

• PostgreSQL环境：使用Django原生ArrayField，支持原生数组类型存储、GIN索引优化查询
• MySQL 5.7+、SQLite、Django 3.1+环境：使用原生JSONField存储数组结构，无额外依赖
  替换后的模型代码示例（以PostgreSQL为例）：

from django.contrib.postgres.fields import ArrayField

class User(AbstractBaseUser, PermissionsMixin):
    id = ShortUUIDField(primary_key=True, editable=False)
    email = models.EmailField(verbose_name="email address", max_length=255, unique=True)
    phone = models.CharField(max_length=50, null=True)
    first_name = models.CharField(max_length=50)
    last_name = models.CharField(max_length=50)
    # 替换原CharField，默认空列表兼容历史空数据
    device_id = ArrayField(
        models.CharField(max_length=255),
        blank=True,
        default=list,
        null=True
    )

非PostgreSQL环境的替换写法：

device_id = models.JSONField(
    default=list,
    blank=True,
    null=True,
    help_text="存储用户关联的所有device_id列表"
)

核心迁移逻辑（零数据丢失） #

直接运行自动生成的迁移会触发原有字符串值与数组类型的不兼容，导致历史数据被清空，必须按以下步骤手动调整迁移流程：

1. 先生成迁移骨架：执行命令python manage.py makemigrations 你的App名称 --name migrate_device_to_array，生成对应的迁移文件后暂不执行
2. 手动编辑生成的迁移文件，在AlterField操作之前插入自定义数据转换逻辑，把原单值字符串转换成数组元素：

from django.db import migrations

def migrate_old_device_to_list(apps, schema_editor):
    User = apps.get_model("你的App名称", "User")
    for user in User.objects.all():
        old_device = getattr(user, "device_id", None)
        # 原有非空单值转成单元素数组，空值统一设为空列表
        user.device_id = [old_device] if old_device else []
        user.save(update_fields=["device_id"])

def rollback_migrate(apps, schema_editor):
    User = apps.get_model("你的App名称", "User")
    for user in User.objects.all():
        device_list = getattr(user, "device_id", [])
        # 回滚时取数组第一个元素还原为原单字段存储格式
        user.device_id = device_list[0] if device_list else None
        user.save(update_fields=["device_id"])

class Migration(migrations.Migration):
    # 关联上一个迁移文件的依赖
    dependencies = [
        ("你的App名称", "上一个迁移文件的编号_迁移名称"),
    ]

    operations = [
        # 先做数据转换，再执行字段结构变更的SQL
        migrations.RunPython(migrate_old_device_to_list, rollback_migrate),
        migrations.AlterField(
            model_name="user",
            name="device_id",
            field=ArrayField(
                models.CharField(max_length=255),
                blank=True,
                default=list,
                null=True
            ),
        ),
    ]

3. 确认迁移逻辑无误后，执行命令python manage.py migrate完成结构变更

改造注意事项 #

• 原有业务代码中所有读取user.device_id单值做判断、对比的逻辑，需要适配为列表匹配规则，例如将user.device_id == "device123"调整为"device123" in user.device_id
• 数据转换逻辑必须放在字段结构变更的SQL操作之前，否则数据库会因为类型不匹配直接清空原有字段值
• 如果使用PostgreSQL，后续可针对device_id字段创建GIN索引，优化“按device_id反查关联用户”的查询效率
• 该方案适合仅需存储device_id列表、不需要关联设备详情扩展字段的场景；如果后续需要存储设备的型号、绑定时间等扩展属性，可再将字段调整为外键关联的Device独立模型

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