如何在Django生产环境中将模型从一个应用迁移至其他应用

前置准备 #

• 全量备份Postgres数据库：执行 pg_dump -U 你的用户名 数据库名 > prod_backup.sql，确保数据可回滚
• 搭建与生产环境完全一致的测试环境（代码、数据、依赖版本），所有操作先在测试环境验证通过
• 确保当前无未应用迁移：执行 python manage.py migrate，确认迁移状态正常

步骤1：创建新应用并迁移模型代码 #

• 创建目标应用：python manage.py startapp target_app，将其添加到settings.py的INSTALLED_APPS中
• 从原应用的models.py中移动指定模型代码到新应用的models.py，同时：
  • 修正模型内部的关联引用（外键、ManyToMany字段），将引用路径从old_app.ModelName改为target_app.ModelName
  • 保留模型的db_table属性（如果已定义），避免触发数据库表名变更
  • 同步移动模型依赖的信号、管理器等相关代码到新应用的对应文件

步骤2：生成并调整迁移文件 #

• 为新应用生成初始迁移：python manage.py makemigrations target_app
• 编辑新应用生成的迁移文件：删除所有创建表的操作（因为表已在数据库中存在），可替换为migrations.RunSQL('')作为空操作占位
• 为原应用生成迁移：python manage.py makemigrations old_app，编辑该迁移文件：删除所有删除表的操作，仅保留移除原模型引用的逻辑

步骤3：更新全局关联引用 #

• 遍历所有剩余模型、视图、序列化器等代码，将所有指向被迁移模型的引用路径从old_app.ModelName更新为target_app.ModelName
• 生成关联更新的迁移：python manage.py makemigrations，检查生成的迁移文件中的SQL语句，确认仅修改关联字段的引用，无破坏性操作

步骤4：应用迁移并验证 #

• 在测试环境执行 python manage.py migrate，检查数据库结构（可通过psql查看表结构、外键约束）
• 测试核心业务逻辑：验证数据查询、创建、修改、删除操作正常，关联数据可正确访问
• 确认测试环境无问题后，在生产环境执行相同迁移步骤（建议低峰期操作）

步骤5：清理冗余内容 #

• 删除原应用中已迁移的模型代码及相关依赖代码
• 清理原应用中拆分后生成的冗余迁移文件（注意保留历史已应用的迁移文件，不可删除）
• 可选：若需规范表归属，可执行Postgres命令 ALTER TABLE 原表名 SET SCHEMA target_app，同步修改模型的db_table属性为target_app.原表名

关键注意事项 #

• 拆分顺序：优先拆分被其他模型引用的基础模型，再拆分依赖它的业务模型
• 避免同时部署业务代码变更，拆分期间仅处理模型迁移相关操作
• 若涉及大型表，提前评估迁移操作的耗时，避免影响生产服务

内容的提问来源于stack exchange，提问作者M.Gafaru