chore(迁移): 新增 V136 版本表 is_latest、V137 隐藏 20 个冗余索引;登记 V132/V133 退役空号
两个迁移原本按 V132/V133 取号,但生产 flyway_schema_history 已执行到 V135(V134/V135 于 2026-09-25 落库),应用没开 out-of-order,低号新迁移会让 validate-on-migrate 直接报 "Detected resolved migration not applied to database" 并启动失败,因此顺排到 V136/V137。 空号无法回收,MigrationInventoryTest 的「1..N 连续」断言改为显式登记 RETIRED_HOLES, 并要求迁移清单文档记录空号来历——否则后来人会试图回填这两个号。 V136:web_config 只追加、从不记录哪条是最新版,读取侧靠 ORDER BY created_at DESC 现场算; 一旦有人补插 created_at 较早的行,/api/version/latest 会把全体客户端指回旧包且不报错。 回填语句按同一排序取一行、不写死 id,迁移前后接口返回值逐字节一致。 V137:20 个「列是另一索引严格左前缀」的二级索引置 INVISIBLE 而非 DROP——前缀规则只保证 可用性不保证代价相同,且 aiimage 账号读不了 performance_schema(1142),没法先量出哪些查询 真在做覆盖扫描,所以先隐藏观察,一条语句即可还原。
This commit is contained in:
@@ -1,22 +1,28 @@
|
||||
# Flyway 迁移盘点(task-193)
|
||||
|
||||
> 生成方式:`src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java`(只读审计,可重复)。
|
||||
> 快照日期:2026-09-05。
|
||||
> 快照日期:2026-09-27。
|
||||
|
||||
## 概览
|
||||
|
||||
- 版本化迁移文件数:**110**(`src/main/resources/db/V*.sql`)
|
||||
- 整数版本范围:**V1..V109 连续**
|
||||
- 版本化迁移文件数:**136**(`src/main/resources/db/V*.sql`)
|
||||
- 整数版本范围:**V1..V137**,其中 V132/V133 为已退役空号(见下),其余连续
|
||||
- 历史遗留小版本:**V25_1__shop_manage_group_bind_user.sql**(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留)
|
||||
- 最新版本:**V109__admin_menu_frontend_routes.sql**
|
||||
- 最新版本:**V137__hide_redundant_indexes_invisible.sql**
|
||||
- 重复版本:无
|
||||
- 迁移命名:全部符合 `V<整数>(_<子版本>)?__<描述>.sql`,无空格
|
||||
|
||||
## 生产已执行核对
|
||||
|
||||
生产 Flyway 已执行到 ≥ V108;本次新增迁移使用 V109(迁移只追加,不回滚历史);新增迁移一律在 V108 之上取 `V109__*`,头注释引用 `docs/flyway-migration-template.md`(task-192)。
|
||||
生产 `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 永久退役,不可回填。
|
||||
|
||||
后续新增迁移从 **V138** 起取号。
|
||||
|
||||
## 约束
|
||||
|
||||
- 审计测试断言:整数版本从 1 到当前最大值连续、无重复文件名、命名正则合规、历史文件校验和可复算稳定。
|
||||
- 修改任何已部署历史迁移会破坏 Flyway checksum,属违规;由本盘点测试的 `no_legacy_modified` 类约束 + code review 把关(git 层是否改动由 CI/review 校验)。
|
||||
- 审计测试断言:整数版本从 1 到当前最大值连续(`RETIRED_HOLES = {132, 133}` 内的号段除外)、无重复文件名、命名正则合规、历史文件校验和可复算稳定。
|
||||
- 修改任何已部署历史迁移会破坏 Flyway checksum,属违规;由本盘点测试 + code review 把关(git 层是否改动由 CI/review 校验)。
|
||||
|
||||
Reference in New Issue
Block a user