feat(多公司): V143 建 company 与 users.company_id,配 12 例迁移护栏

一期只做账号归属:company 主表 + users.company_id,57 张业务表零 DDL、零回填,
公司维度全部由 user_id → users.company_id 派生。存量账号在迁移里归入「厦门米椿花」,
不需要另外拿脚本对着生产库 UPDATE。

两个不落进代码就会丢的判断:

1) 每条语句都写成幂等。MySQL 的 DDL 不进事务,NOT NULL 闸门失败时前面的建表/插数/加列
   已经落库,而 repair + 重启会让 Flyway 从第一条语句重跑整个文件;写成裸 CREATE TABLE /
   裸 INSERT 的话,恢复路径自己撞 1050/1060/1062,"补数据后重启"就变成"必须手工清库"。
2) 回滚是 docs/rollback-V143-company.sql,不是一条 V144 迁移。放进 src/main/resources/db/
   等于让 Flyway 在下次启动时自动执行回滚。这两条口径一并写进 migration-inventory.md 的
   约束段,供后续所有迁移引用。

闸门留 DEFAULT 1 只为混合版本窗口存在(旧 jar 建号不带 company_id),摘除时机改由启动期
巡检盯(下一步实现),不靠人记。

CompanyMigrationV143Test 12 例,断言打在剥掉注释后的可执行 SQL 上(否则"注释里写了这句话"
就算通过);16 条变异全部被抓到。全量 mvn test 3515 例 0 红。

后端 modules/company、两端前端、DEFAULT 摘除巡检尚未开始。
This commit is contained in:
2026-10-04 03:27:27 +08:00
parent 7ad4932bd5
commit 5633898a0d
5 changed files with 637 additions and 74 deletions
+7 -5
View File
@@ -1,14 +1,14 @@
# Flyway 迁移盘点(task-193)
> 生成方式:`src/test/java/com/nanri/aiimage/config/MigrationInventoryTest.java`(只读审计,可重复)。
> 快照日期:2026-10-01;2026-10-03 随 V142 追加时同步过概览数字与取号起点。
> 快照日期:2026-10-01;2026-10-03 随 V142 追加时同步过概览数字与取号起点;2026-10-04 随 V143 同步。
## 概览
- 版本化迁移文件数:**141**(`src/main/resources/db/V*.sql`,其中整数版本 140 个 + 小版本 V25_1)
- 整数版本范围:**V1..V142**,其中 V132/V133 为已退役空号(见下),其余连续
- 版本化迁移文件数:**142**(`src/main/resources/db/V*.sql`,其中整数版本 141 个 + 小版本 V25_1)
- 整数版本范围:**V1..V143**,其中 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 待下一次发版执行)
- 最新版本:**V143__company_and_users_company_id.sql**(V141 已于 2026-10-03 随 jar 上线两台;V142/V143 待下一次发版执行)
- 重复版本:无
- 迁移命名:全部符合 `V<整数>(_<子版本>)?__<描述>.sql`,无空格
@@ -20,7 +20,7 @@
本地曾存在 `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` 会红)。
后续新增迁移从 **V144** 起取号(只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,`integerVersionsSequentialFromOne` 会红)。
原先挂在待办里的"V137 冗余索引 DROP"迁移计划取 V139,该号已被 `V139__asin_result_cache.sql` 占用,顺延到 V140;V140 已被品牌补测队列表 `V140__collectdata_brand_recheck.sql` 落用。
@@ -28,3 +28,5 @@
- 审计测试断言:整数版本从 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,把"补数据后重启"变成"必须手工清库"。
@@ -0,0 +1,45 @@
-- =============================================================
-- V143 回滚补丁:撤销多公司一期(company 主表 + users.company_id + 后台「公司管理」菜单)
--
-- 【为什么是一个手工脚本,而不是一条 V144 迁移】
-- src/main/resources/db/ 是 Flyway 的扫描路径,放进去的任何 V*.sql 都会在应用下次启动时
-- 被自动执行。把回滚写成 V144__rollback_company.sql 的后果是:哪怕没人打算回滚,
-- 只要集群里还起着带这个文件的 jar,Flyway 就会静默撤销 V143——表没了、列没了、
-- 已归属公司的账号全变回无公司状态。回滚必须是一个"只有决定回滚时才有人跑"的东西。
--
-- 前置事实:V143 从未给任何业务表加列,所以业务数据不受影响,回滚面只有 users 这一列。
-- 回滚后已建的 company_id 值一并丢失,账号本身、密码、角色、权限都不受影响。
--
-- 执行顺序(缺一都会留下不一致状态):
-- 1. 停两台 java 应用 —— 否则回滚窗口里新代码还在往 users.company_id 写,会报 unknown column
-- 2. 在 MySQL 上按本文件顺序执行(先删索引再删列,反了会 ER_CANT_DROP_FIELD_OR_KEY 之外还留残索引)
-- 3. 把 flyway_schema_history 里本版本那行删掉(本文件最后一条语句)
-- 不删的后果:将来重新部署带 V143 的 jar 时,Flyway 认为"已应用"直接跳过,
-- 表和列都不会重建,而 Java 侧实体照常读写 company_id ⇒ 运行期报 unknown column
-- 4. 回滚 jar 到 V142 版本,再起应用
-- 5. 若两台不能同时停(滚动回退),必须保证第 2、3 步在**两台都已停下**之后才做
-- =============================================================
ALTER TABLE `users` DROP INDEX `idx_users_company_id`;
ALTER TABLE `users` DROP COLUMN `company_id`;
DROP TABLE IF EXISTS `company`;
DELETE FROM `columns` WHERE `column_key` = 'admin_companies';
DELETE FROM `flyway_schema_history` WHERE `version` = '143';
-- =============================================================
-- 验证(回滚后执行)
-- SHOW COLUMNS FROM `users` LIKE 'company_id'; -> 期望 0 行
-- SHOW INDEX FROM `users` WHERE Key_name = 'idx_users_company_id';
-- -> 期望 0 行
-- SHOW TABLES LIKE 'company'; -> 期望 0 行
-- SELECT COUNT(*) AS menu_rows FROM `columns` WHERE `column_key` = 'admin_companies';
-- -> 期望 0
-- SELECT `version` FROM `flyway_schema_history` WHERE `version` = '143';
-- -> 期望 0 行
-- SELECT COUNT(*) AS max_version FROM `flyway_schema_history`
-- WHERE CAST(`version` AS UNSIGNED) > 142; -> 期望 0
-- =============================================================