生产环境下Django+Postgres添加模型字段时迁移异常问题

可能的原因及解决步骤 #

1. 迁移文件未在生产环境实际执行 #

• 执行python manage.py showmigrations（Django项目场景），查看对应app的迁移记录，确认最新迁移文件前是否有[X]标记——没有则说明未执行。
• 先排查依赖冲突：运行python manage.py migrate --plan查看迁移执行计划，确认无冲突后，执行python manage.py migrate <你的app名>指定app完成迁移。
• 核心提醒：执行前必须备份生产数据库，避免意外。

2. 迁移执行中途失败 #

• 查看生产环境迁移日志，或重新执行迁移获取具体报错——大概率是之前执行时因数据库锁、连接中断等问题，导致迁移未完成，但数据库的django_migrations表（Django场景）错误标记为已执行。
• 解决方式：先备份数据库，手动删除django_migrations表中对应app的该迁移记录，再重新执行迁移。

3. 代码拉取不全或缓存异常 #

• 确认生产环境代码已同步至最新版本，重点核对migrations目录下的文件与远程仓库是否一致，避免漏拉文件。
• 若为Django项目，清理缓存：python manage.py clearcache，同时重启应用服务——旧模型定义可能被缓存，导致代码与运行逻辑不一致。

4. 字段定义存在隐性问题 #

• 检查新增字段的代码：比如是否设置了db_column参数但数据库列名与模型字段名不匹配；或字段类型与数据库兼容度不足，导致迁移未实际创建字段。
• 直接登录生产数据库，查看对应表的结构，确认字段是否真的存在。若不存在，可选择：①手动创建字段（需保证属性与模型完全一致，操作前备份数据）；②本地重新生成迁移文件：python manage.py makemigrations --force <你的app名>，推送至远程后再在生产环境执行迁移。

5. 多实例部署同步问题 #

• 若生产环境为多实例部署，确认所有实例均已拉取最新代码，且迁移仅在单个实例上执行——多实例同时执行迁移易引发冲突。
• 迁移完成后，重启所有实例，确保加载最新模型定义。

数据安全必做事项 #

• 任何操作前先备份生产数据库，使用数据库自带工具即可，比如PostgreSQL用pg_dump，MySQL用mysqldump。
• 尽量选择低峰时段操作，减少对用户的影响。
• 若对操作结果存疑，先在测试环境复现问题并验证解决方案，再应用到生产环境。

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