已有模型和迁移的Django项目如何恢复数据库dump备份

核心问题说明 #

你遇到的Django不识别外部恢复数据库的问题，本质不是Django无法使用外部导入的库，而是没有保证两个核心匹配条件：

1. 库中django_migrations系统表的执行记录，与项目本地的迁移文件完全匹配
2. 实际表结构与项目模型的定义完全匹配
   只要满足这两个条件，不管是用什么方式恢复的数据库，Django ORM都可以正常使用，包含managed=False的模型：managed=False只是告诉Django不用通过迁移系统增删改该表的结构，只要表存在、字段和模型定义一致，ORM的读写操作完全不受影响。

方案1：全量SQL备份恢复（适合同版本项目快速部署） #

如果你的SQL备份是从当前要部署的同版本项目的生产/测试库导出的全量备份（包含django_migrations等Django系统表），可以用该方案：

• 步骤1：在新环境的MySQL中创建空数据库，配置好Django settings.py中的数据库连接参数，确保账号有该库的全部操作权限
• 步骤2：登录MySQL执行恢复操作：

# 进入备份文件所在目录后登录MySQL
mysql -u your_username -p

create database your_db_name default charset utf8mb4;
use your_db_name;
source /path/to/your/backup.sql;

• 步骤3：验证迁移一致性，在项目根目录执行命令：

python manage.py migrate --check

如果无报错输出，说明迁移记录完全匹配，可直接正常使用项目；如果提示迁移未执行，确认你的备份对应的项目版本和当前部署版本完全一致的前提下，执行伪迁移标记记录即可：

python manage.py migrate --fake

方案2：Django原生数据导入导出（适合跨版本/仅迁移业务数据场景） #

如果你的备份和当前项目版本有差异，或者只需要迁移业务数据不需要保留原库的迁移记录，可以用Django自带的dumpdata/loaddata工具：

• 步骤1：在新环境创建空数据库，配置好Django数据库连接后，先执行全量迁移生成符合当前项目定义的表结构：

python manage.py migrate

• 步骤2：如果有managed=False的模型，手动在新库中创建对应表结构，或从原备份中单独导出这部分表的结构导入新库
• 步骤3：在原库所在环境的项目根目录导出全量业务数据（仅包含Django管理的表数据，managed=False的表不会导出，需单独备份数据）：

python manage.py dumpdata > all_data.json

• 步骤4：将导出的json文件传到新环境项目根目录，执行数据导入：

python manage.py loaddata all_data.json

导入完成即可直接使用，不存在迁移不匹配的问题。 #

注意事项 #

• 用方案1时，不要随意对跨版本的备份执行正常migrate操作，可能会导致表结构冲突、数据丢失
• 如果需要对managed=False的表做结构调整，需手动操作数据库，再同步修改项目中的模型定义即可

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