Files
crawler-plugin/backend-java/docs/rollback-V143-company.sql
T
huangzd1997 5633898a0d 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 摘除巡检尚未开始。
2026-10-04 03:27:27 +08:00

46 lines
2.9 KiB
SQL

-- =============================================================
-- 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
-- =============================================================