Django现有表新增HASH列 迁移后旧数据UUID重复如何解决
存量用户UUID重复的解决方案
核心问题原因
Django在执行表结构迁移、新增非空字段时,不会逐行调用你写的可调用默认值函数,只会在迁移文件生成时取一次这个函数的返回值,把这个固定值当常量批量填充所有存量行——这就是为什么所有老用户拿到了完全一样的UUID。你写的default=_create_uuid逻辑,只对迁移完成后新创建的用户对象生效,根本覆盖不到存量数据的回填流程。
落地操作步骤
- 先重置错误的填充状态
如果已经跑过带默认值的迁移,把所有存量用户的uuid值批量清空。如果项目还在开发、没正式上线,直接把之前生成的带默认值的add field迁移文件删掉重来,是最省时间的方式。 - 拆分迁移动作,避免迁移时批量填值
- 临时修改模型里的uuid字段定义:暂时加上
null=True,移除原来的default=_create_uuid参数def _create_uuid(): return uuid.uuid4().hex[:20] class users(models.Model): user_id = models.CharField(max_length=100, primary_key=True) # 临时设置可空、无默认值,避免迁移触发批量填充 uuid = models.CharField(max_length=20, null=True) - 执行
python manage.py makemigrations生成第一个迁移文件:这个迁移只会给表结构加一个可空、无默认值的uuid列,不会触发任何批量填值逻辑,直接跑python manage.py migrate把这个表结构改动应用到数据库。
- 临时修改模型里的uuid字段定义:暂时加上
- 写自定义数据迁移,逐行回填唯一UUID
用Django自带的RunPython操作写专门的迁移逻辑,遍历所有存量用户记录,逐行调用_create_uuid方法生成唯一值更新回去。
自定义迁移的核心逻辑示例:
这个迁移写好之后直接跑migrate,就会逐行给所有老用户生成不重复的UUID,不会出现批量填同一个值的问题。import uuid from django.db import migrations def backfill_uuid(apps, schema_editor): # 注意这里一定要用迁移时的历史模型,不要直接导入项目里的users模型,避免后续模型变更影响迁移 User = apps.get_model("你的app名称", "users") # 用iterator分批拉取,避免大表遍历内存溢出 for user in User.objects.all().iterator(chunk_size=1000): user.uuid = uuid.uuid4().hex[:20] # 只更新uuid字段,减少不必要的写入开销 user.save(update_fields=["uuid"]) class Migration(migrations.Migration): dependencies = [ # 替换成你上一步生成的加列迁移的标识,比如("accounts", "0003_add_users_uuid") ] operations = [ migrations.RunPython(backfill_uuid, migrations.RunPython.noop) ] - 恢复正式的字段约束
等存量数据全部回填完成后,再把模型里的uuid字段改回正式定义:去掉临时加的null=True,重新加上default=_create_uuid和null=False,再执行makemigrations生成最后一个约束调整的迁移,应用之后整个流程就完成了。
实操注意事项
- 千万不要在自定义数据迁移里直接导入项目里的users模型,必须用
apps.get_model()拿迁移对应的历史模型,不然后续模型字段变动很容易让老迁移跑失败。 - 如果用户表数据量特别大,回填的时候一定要加chunk_size分批拉取,不要一次性把全表加载到内存里。
- 虽然UUID4生成的20位hex重复概率极低,如果业务对唯一性要求极高,可以在生成后加个校验,遇到重复就重新生成,规避极端冲突。
内容的提问来源于stack exchange,提问作者N3mo
相关产品推荐
相关产品推荐

