Django数据迁移处理全攻略

在 Django 中处理迁移数据是项目开发中的常见任务，主要用于同步数据库结构与模型定义。正确管理迁移能避免数据丢失或结构错乱。

理解 Django 迁移的作用

Django 迁移（migrations）是将模型的变更应用到数据库的机制。每次修改 models.py（如新增字段、创建新模型等），都需要生成并执行迁移文件来更新数据库表结构。

核心命令包括：

• python manage.py makemigrations：根据模型变化生成迁移文件
• python manage.py migrate：将迁移文件应用到数据库
• python manage.py showmigrations：查看哪些迁移已应用

常见迁移操作场景与处理方法

开发中常遇到以下情况，需针对性处理：

1. 创建并应用新迁移

• 修改模型后运行 makemigrations，Django 会提示检测到哪些变更
• 确认无误后执行 migrate 将变更写入数据库

2. 处理迁移冲突

• 多人协作时可能产生重复或冲突的迁移文件
• 可通过合并迁移或重命名（保持依赖顺序）解决
• 使用 showmigrations 检查应用状态，必要时手动调整迁移依赖

3. 回滚迁移

• 用 python manage.py migrate app_name 0001 回退到指定版本
• 回退前务必备份数据库，防止数据丢失
• 删除迁移文件前确保没有其他环境依赖它

数据迁移：处理已有数据

除了结构迁移，有时需要在迁移中操作数据（如填充默认值、转换字段格式）：

• 使用 makemigrations --empty your_app_name 创建空迁移文件
• 在生成的文件中编写 RunPython 操作
• 例如批量更新某字段值，或从旧字段提取信息到新字段

示例代码片段：

from django.db import migrations

def forwards_func(apps, schema_editor):
    MyModel = apps.get_model("myapp", "MyModel")
    for obj in MyModel.objects.all():
        obj.new_field = f"converted_{obj.old_field}"
        obj.save()

class Migration(migrations.Migration):
    dependencies = [
        ("myapp", "0002_auto"),
    ]
    operations = [
        migrations.RunPython(forwards_func, reverse_code=migrations.RunPython.noop),
    ]

最佳实践建议

• 提交迁移文件到版本控制，确保团队一致
• 避免在生产环境中直接修改迁移历史
• 敏感操作前导出数据备份
• 定期清理未使用的迁移（仅限开发早期，需谨慎）

基本上就这些。掌握好迁移流程，能让数据库演变更安全可控。