Files
crawler-plugin/backend-java/docs/migration-inventory.md
T
huangzd1997 4b7405895d feat(更新链路): web_config 加 sha256(V142),/api/version/latest 回带包摘要
客户端自更新过去只验 zip 结构:桶里的包被换掉时,结构完整的恶意 zip 会直接交给
update.exe 解压执行。摘要必须由服务端给出才与下载来源无关——能替换对象的人替换不了这个接口。

- V142 加 sha256 列(可空、不回填历史行,列缺失时客户端行为不变);
- /latest、公开列表、后台上传响应都回带摘要;multipart 上传按真正落盘的字节算;
- 直传确认路径不重算摘要(那要把 100MB 对象拉回来),这类行留空由发布脚本回填。

盘点文档同步:V1..V142、141 个文件、后续从 V143 取号。
2026-10-03 15:41:49 +08:00

2.3 KiB
Raw Blame History

Flyway 迁移盘点(task-193)

生成方式:src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java(只读审计,可重复)。 快照日期:2026-10-01;2026-10-03 随 V142 追加时同步过概览数字与取号起点。

概览

  • 版本化迁移文件数:141(src/main/resources/db/V*.sql,其中整数版本 140 个 + 小版本 V25_1)
  • 整数版本范围:V1..V142,其中 V132/V133 为已退役空号(见下),其余连续
  • 历史遗留小版本:V25_1__shop_manage_group_bind_user.sql(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留)
  • 最新版本:V142__web_config_sha256.sql(V141 已于 2026-10-03 随 jar 上线两台;V142 待下一次发版执行)
  • 重复版本:无
  • 迁移命名:全部符合 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 永久退役,不可回填。

后续新增迁移从 V143 起取号(只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,integerVersionsSequentialFromOne 会红)。

原先挂在待办里的"V137 冗余索引 DROP"迁移计划取 V139,该号已被 V139__asin_result_cache.sql 占用,顺延到 V140;V140 已被品牌补测队列表 V140__collectdata_brand_recheck.sql 落用。

约束

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