如何在已填充数据的Django生产数据库中将IntegerField改为CharField？

嘿，这个问题我之前在生产环境踩过坑！从错误提示来看，你用的应该是PostgreSQL数据库——直接把IntegerField改成CharField时，要么是数据库在转换数据时触发了隐含的类型比较，要么是你的代码里还有地方把这个字段当成整数来用（比如filter(number__gte=100)这类查询），导致数据库找不到varchar >= integer对应的运算符。

下面是一套适合生产环境的安全迁移方案，不会直接动原有字段，最大程度降低业务风险：

步骤1：添加临时字段并迁移数据 #

先不要直接修改原有number字段，而是新增一个临时的CharField，把原有整数数据转成字符串存进去：

生成的迁移文件代码大概是这样（记得替换your_app为你的实际app名称）：

from django.db import migrations, models

def migrate_number_to_temp(apps, schema_editor):
    Room = apps.get_model('your_app', 'Room')
    # 分批处理数据，避免大数据量时锁表或内存溢出
    for room in Room.objects.all().iterator():
        room.number_temp = str(room.number)
        room.save(update_fields=['number_temp'])

class Migration(migrations.Migration):
    dependencies = [
        # 这里填你上一次迁移的名称，比如('your_app', '00XX_xxxx')
    ]

    operations = [
        # 添加允许为空的临时字段
        migrations.AddField(
            model_name='room',
            name='number_temp',
            field=models.CharField(max_length=32, null=True, blank=True),
        ),
        # 运行数据迁移，把原有整数转成字符串
        migrations.RunPython(migrate_number_to_temp),
    ]

提示：如果Room表数据量很大，一定要用iterator()分批处理，避免一次性加载所有数据到内存，同时减少锁表时间对业务的影响。

步骤2：修改代码中所有用到number的地方 #

把项目里所有引用room.number的地方，全部改成room.number_temp，包括但不限于：

• 视图函数、序列化器里的查询逻辑（比如Room.objects.filter(number__gte=100)要改成Room.objects.filter(number_temp__gte='100')，注意把整数参数改成字符串）
• 模板里的变量引用
• Admin后台的list_display、list_filter、search_fields配置
• 信号量、任务队列里的相关逻辑

这一步一定要仔细排查，漏改任何一处都会导致后续运行出错。

步骤3：替换原有字段 #

确认代码全量修改完成并测试通过后，部署新代码，然后生成最终的迁移文件，把临时字段替换成原来的number：

迁移文件代码示例：

from django.db import migrations

class Migration(migrations.Migration):
    dependencies = [
        # 这里填步骤1生成的迁移名称
    ]

    operations = [
        # 把临时字段设为非空（如果原有number字段是必填的）
        migrations.AlterField(
            model_name='room',
            name='number_temp',
            field=models.CharField(max_length=32),
        ),
        # 删除原有IntegerField字段
        migrations.RemoveField(
            model_name='room',
            name='number',
        ),
        # 把临时字段重命名为number
        migrations.RenameField(
            model_name='room',
            old_name='number_temp',
            new_name='number',
        ),
    ]

关键注意事项 #

• 生产环境操作前必须备份数据库：这是底线，万一迁移出问题可以快速回滚。
• 先在测试环境完整走一遍流程：确保数据转换正确，代码没有遗漏修改的地方。
• 检查数据库层面的约束/索引：如果原有number字段有索引或者外键关联，也要同步调整到新字段上。

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