Files
crawler-plugin/backend-java/docs/migration-inventory.md
T
huangzd1997 ac8b34afcc docs(运维): §十九/§二十 发版记录(看板 c6ee759d)与 SQL 空跑发现的 collation 热修(8c9141d6 待发布)
§十九 记录 Java 双机 + 麦象接口 + admin-vue 三处同批上线与回读口径;
§二十 记录把 21 条 @Select 渲染进生产库只读空跑发现设备页 3 条语句 ERROR 1271、
修复与验证数字、以及"授权菜单前必须先发热修"的顺序约束。
顺带把盘点里的取号提示 V138 → V139。
2026-09-29 00:22:13 +08:00

1.7 KiB
Raw Blame History

Flyway 迁移盘点(task-193)

生成方式:src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java(只读审计,可重复)。 快照日期:2026-09-28。

概览

  • 版本化迁移文件数:137(src/main/resources/db/V*.sql)
  • 整数版本范围:V1..V138,其中 V132/V133 为已退役空号(见下),其余连续
  • 历史遗留小版本:V25_1__shop_manage_group_bind_user.sql(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留)
  • 最新版本:V138__client_task_console.sql
  • 重复版本:无
  • 迁移命名:全部符合 V<整数>(_<子版本>)?__<描述>.sql,无空格

生产已执行核对

生产 flyway_schema_history 末段:V125..V131 之后直接是 V134__publish_item_free_text_columns、V135__dedupe_total_data_wide_columns(两条 installed_on 均为 2026-09-25 20:46:16),库内没有 132/133 记录。

V132/V133 空号的来历

本地曾存在 V132__web_config_add_is_latest.sql、V133__hide_redundant_indexes_invisible.sql,与另一分支已在生产落库的 V134/V135 冲突。因 Flyway 未开启 out-of-order,把任何迁移编到 132/133 会在启动期报 "resolved migration not applied";因此这两条改为 V136/V137,132/133 永久退役,不可回填。

后续新增迁移从 V139 起取号。

约束

  • 审计测试断言:整数版本从 1 到当前最大值连续(RETIRED_HOLES = {132, 133} 内的号段除外)、无重复文件名、命名正则合规、历史文件校验和可复算稳定。
  • 修改任何已部署历史迁移会破坏 Flyway checksum,属违规;由本盘点测试 + code review 把关(git 层是否改动由 CI/review 校验)。