Heroku环境下Flask数据库迁移执行后未更新数据库架构问题

核心异常信号 #

从日志就能直接判断升级流程根本没执行实际变更：正常成功跑迁移时，alembic一定会输出类似Running upgrade <旧版本哈希> -> a92ff10fdb60的关键记录，你当前的upgrade日志仅完成了数据库引擎初始化就结束，说明升级逻辑根本没匹配到可执行的迁移脚本，自然不会修改表结构。

具体可能的诱因 #

• 错误操作路径：在Heroku上执行flask db migrate
  Heroku的所有运行实例（dyno）都是临时容器，文件系统在容器退出、重启后会完全重置清空。你在Heroku上跑migrate时，虽然能正常检测到模型和表的字段差异、临时在容器内生成迁移脚本，但脚本生成完对应run.6994的容器就销毁了；后续执行upgrade的新容器启动时，根本找不到这份临时存在过的脚本，自然不会执行新增字段的逻辑。正确流程本来是在本地生成迁移文件、提交到Git、推完代码部署到Heroku之后，只在Heroku上跑upgrade，你把流程反了。
• Git仓库未提交本次变更对应的迁移脚本
  如果你改完模型的字段定义后，没在本地跑flask db migrate生成迁移脚本，也没把新增的脚本提交到和Heroku关联的代码分支，Heroku部署的代码包里根本没有“给users表加active、password两列”的升级逻辑。哪怕临时在Heroku上生成过迁移文件，文件也留不住，alembic检测不到版本差，就直接跳过升级。
• 数据库连接指向不一致
  Heroku应用实际执行操作连接的数据库，是由DATABASE_URL环境变量指定的，如果你这个环境变量配错了，应用实际连的是测试库、临时sqlite库执行迁移，而你自己用SQL客户端查询的是另一个生产库，两边操作的根本不是同一个库，自然看不到表结构变化。
• 迁移版本记录错位
  如果之前的部署流程已经在alembic_version表里写入了最新的版本号，但对应的迁移脚本没推到Heroku上，alembic会直接判定当前数据库已经是最新状态，不会重复执行字段变更。

快速排查步骤 #

• 跑heroku run flask db current，看Heroku应用识别到的当前迁移版本，和你期望执行的a92ff10fdb60版本做对比，确认是否存在版本不匹配
• 检查Git仓库里的migrations/versions目录，确认是不是真的有包含新增两个字段逻辑的迁移脚本，文件有没有提交、有没有推到Heroku关联的分支
• 跑heroku config:get DATABASE_URL，对比返回的连接地址，和你本地SQL客户端连的库是不是同一个

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