品牌库/去重库原本没有公司这一列、唯一键是全局的,所以"每公司一套"无从谈起。 V145 破例物化 company_id(含品牌库的 uploader_user_id 审计锚点),并把 uk_data_value / uk_data_value_brand 换成带 company_id 前缀的新键(先 ADD 后 DROP)。 按生产实查改写了计划里的写法:biz_dedupe_total_data 507,306 行 / MySQL 8.4.8, 非末位加列与 MODIFY 收 nullability 都要重建表,故三条加列显式钉 ALGORITHM = INSTANT、 列直接建成 NOT NULL DEFAULT 1、四条索引操作钉 INPLACE, LOCK = NONE, 回填换成由 users 驱动、带 d.company_id = 1 幂等限定的反推 UPDATE。 DEFAULT 1 是为混合版本窗口留的(批量写失败只 log.warn,缺列会静默丢数), 摘它必须用 ALTER COLUMN ... DROP DEFAULT——MODIFY 会按当时列默认值物化 instant 列, 把反推好的归属洗回 1。启动期哨兵据此从只探 users 扩成探三张表。 第二家公司已于 10-04 14:55 开通,历史行的实际上传者从此不可追溯,这笔不能再等。 回滚走 docs/rollback-V145-company-scope.sql 人工补丁,不编成 V146(Flyway 扫描路径会自己跑)。
4.6 KiB
Flyway 迁移盘点(task-193)
生成方式:
src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java(只读审计,可重复)。 快照日期:2026-10-01;2026-10-03 随 V142 追加时同步过概览数字与取号起点;2026-10-04 随 V143 同步;2026-10-04 随 V144 同步;2026-10-04 15:1x 随 V145 同步。
概览
- 版本化迁移文件数:144(
src/main/resources/db/V*.sql,其中整数版本 143 个 + 小版本 V25_1) - 整数版本范围:V1..V145,其中 V132/V133 为已退役空号(见下),其余连续
- 历史遗留小版本:V25_1__shop_manage_group_bind_user.sql(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留)
- 最新版本:V145__brand_dedupe_company_scope.sql(V142 已于 10-03 18:23 应用、V143 已于 10-04 10:48 应用、V144 已于 10-04 13:22 应用;V145 待下一次 jar 发版执行)
- 重复版本:无
- 迁移命名:全部符合
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 永久退役,不可回填。
后续新增迁移从 V146 起取号(只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,integerVersionsSequentialFromOne 会红)。
原先挂在待办里的"V137 冗余索引 DROP"迁移计划取 V139,该号已被 V139__asin_result_cache.sql 占用,顺延到 V140;V140 已被品牌补测队列表 V140__collectdata_brand_recheck.sql 落用。
已应用迁移的存量校验和(2026-10-04 15:0x 从生产 flyway_schema_history 实查)
| 版本 | 文件 | 校验和 | installed_on |
|---|---|---|---|
| 142 | V142__web_config_sha256.sql |
1152261840 |
2026-10-03 18:23:22 |
| 143 | V143__company_and_users_company_id.sql |
1539570901 |
2026-10-04 10:48:54 |
| 144 | V144__users_company_id_drop_default.sql |
1833593804 |
2026-10-04 13:22:00 |
这三行的字节就此封死。校验和算法是 Flyway 的 CRC32 逐 BufferedReader.readLine() 的 UTF-8 字节累加(行尾不入 CRC,所以 CRLF 工作树与 LF 工作树算出同一个值);上表三个值都被 CompanyMigrationV144Test#appliedMigrationBytesAreFrozenAgainstProdChecksum 用工作树字节复算并比对过。
真事:10-04 上午有人(我)把"摘掉 users.company_id 的 DEFAULT"直接改成原地编辑 V143,取证才发现 V143 已在 10:48 落库——那样发出去的 jar 会让下次启动 Flyway 校验失败、两台 java 都起不来。口径变更因此写成 V144 前向修复,并把"已应用不许原地改"从注释升级成上面那条用例。
约束
- 审计测试断言:整数版本从 1 到当前最大值连续(
RETIRED_HOLES = {132, 133}内的号段除外)、无重复文件名、命名正则合规、历史文件校验和可复算稳定。 - 修改任何已部署历史迁移会破坏 Flyway checksum,属违规;由本盘点测试 + code review 把关(git 层是否改动由 CI/review 校验)。
- 回滚不得写成版本化迁移。 本目录是 Flyway 扫描路径,任何
V*.sql都会在应用下次启动时自动执行;把回滚编成V{N+1}__rollback_*.sql等于让"决定回滚"这件事在没有人工执行的情况下自己发生。回滚一律是本目录之外的人工补丁脚本(首例:docs/rollback-V143-company.sql),并要按"停应用 → 跑脚本 → 删flyway_schema_history对应版本行 → 回滚 jar"的顺序做,漏掉删历史那步会让将来重装时 Flyway 判定"已应用"而跳过重建。 - 迁移必须可重跑。 MySQL 的 DDL 不进事务:迁移中途失败时前面的语句已经落库,而
flyway repair+ 重启会让 Flyway 从第一条语句重跑整个文件。所以建表用IF NOT EXISTS、插种子行用INSERT IGNORE或WHERE NOT EXISTS、ADD COLUMN/INDEX先查information_schema再PREPARE(首例:V142 的条件 DDL、V143 全文件)。写成裸CREATE TABLE/ 裸INSERT ... VALUES的迁移,恢复路径本身会撞 1050/1060/1062,把"补数据后重启"变成"必须手工清库"。