中国 帮助

迁移脚本不能改:checksum 与 21 号迁移

平台按 (app_code, script) 记账并保存脚本内容的 sha256。同名脚本内容一变,安装当场抛异常中断。这篇复盘一次真实的打包事故,以及为什么正确做法是「还原旧脚本、新加编号」。

迁移脚本不能改:checksum 与 21 号迁移

现象

某次发版后,一个已经跑过部分迁移的库装新包时直接失败,错误信息是「迁移脚本 20-… 的内容已被修改(摘要与首次执行时不一致),为避免同一脚本产生两种结果,拒绝执行。请改用新的脚本名。」

不是警告,是中断安装。

a

机制

AppMigrationService 有一张 app_schema_history 记账表,键是 (app_code, script),同时记下脚本内容 LF 归一化后的 sha256 与执行时间。每次安装遇到同名脚本,先比摘要:一致就跳过,不一致就抛异常。

这条设计是对的。假设允许改,同一个 20 号脚本在 A 库插入「分类」、在 B 库插入「分类目录」,半年后没人说得清某个库到底长什么样。宁可当场拒绝。

根因

本地工作副本里有一条未提交的改动:把 20 号脚本里插入的菜单文案从「分类」改成「分类目录」,还加了图标。打包脚本收的是工作目录,于是这个包里装的是改过的版本。而线上库在几天前已经跑过原始 20 号,记账里的摘要是原版。

校验一下就露馅了:git HEAD 里的 20 号 LF 归一化摘要 ca60bd0289693128…,工作副本是 4e1ef4a8…,而线上 app_schema_history 记的正是前者。

b

修法

先把 20 号还原成已发布原样(摘要校验一致),再新增 21-cms-menu-category-label-icon.sql 做条件更新:

UPDATE cms_menu_item
   SET label = '分类目录', icon = '🏷️'
 WHERE id = 9161
   AND label = '分类'
   AND (icon IS NULL OR icon = '');

条件是关键:只改还是种子原样的那一行,后台手工改过名字的不覆盖;行被删过就命中 0 行,不影响安装。全新装库和已部署的库最终状态一致。

三条纪律

一,执行过的迁移脚本不改,只加新编号。二,打包前检查工作区是否干净,尤其 migrations/。三,发版包的迁移摘要要和线上记账对一遍。这三条任何一条做到,这次事故都不会发生。

THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容