feat(多公司): V144 摘掉 users.company_id 的默认值,并把「已应用迁移不许原地改」做成护栏

V143 已于 2026-10-04 10:48:54 应用到生产库(校验和 1539570901),而
spring.flyway.validate-on-migrate=true 是硬编码 —— 想摘 DEFAULT 就不能原地改 V143,
否则下一次启动校验失败、两台 java 都起不来。所以按前向修复写成 V144,并让
CompanyMigrationV144Test 按 Flyway 的 CRC32 复算 V142/V143 与生产存量校验和比对,
把这件事从口头纪律变成 mvn test 阶段能咬红的护栏。

取舍:宁可让绕过 createUser 的写入撞 MySQL 1364 炸在日志里,也不要被静默塞进
厦门米椿花(users 全仓只有 1 条 INSERT,且它恒显式赋值,故不会新增失败面)。

- V144:ALTER TABLE users MODIFY COLUMN company_id bigint NOT NULL(不带 DEFAULT),
  头注释含模板六项 + 验证 SQL(期望 Default = NULL)+ 人工回滚步骤
- CompanyMigrationV144Test 8 例,变异自证 7/7 被咬死(含「原地改 V143」那条)
- CompanyMigrationV143Test 删掉「V143 必须是当前最大版本」——V144 落盘后它是假前提,
  号段连续性仍由 MigrationInventoryTest 把守
- migration-inventory.md:文件数 143、范围 V1..V144、取号起点 V145、新增存量校验和表
This commit is contained in:
2026-10-04 11:49:14 +08:00
parent e832418f4b
commit 94f160b316
4 changed files with 364 additions and 7 deletions
@@ -0,0 +1,59 @@
-- =============================================================
-- 迁移 V144__users_company_id_drop_default
-- 模板:docs/flyway-migration-template.md
-- 设计:crawler-plugin/docs/ops/company-multi-tenant-design-2026-10-04.md §6.3 / §8.2
--
-- 1. 变更目的:摘掉 V143 给 users.company_id 落上的列默认值 DEFAULT 1。
-- 定案是「账号归属只由 V143 的存量回填与 AdminUserService.createUser 显式决定」。
-- 留着 DEFAULT 只有一个后果:任何绕过 createUser 的写入(旧 jar、手工 SQL、将来漏改的
-- 入口)被静默塞进厦门米椿花——第二家公司开通后这就是归属失真,且一声不响。
-- 宁可撞 MySQL 1364(Field 'company_id' doesn't have a default value)炸在日志里,
-- 也不要静默归错公司。
--
-- 【为什么是 V144 而不是原地改 V143】V143 已于 2026-10-04 10:48:54 被应用到生产库
-- (flyway_schema_history 校验和 1539570901)。spring.flyway.validate-on-migrate=true 是
-- 硬编码,原地改已应用迁移的字节 ⇒ 下一次启动校验失败、两台 java 都起不来。
-- 所以已应用迁移的字节就此封死,口径变更一律写成下一条迁移(前向修复)。
-- 这条封死由 CompanyMigrationV144Test#appliedMigrationBytesAreFrozenAgainstProdChecksum 把守。
-- 2. 影响表与数据量:仅 users 一列的默认值属性。生产实查 139 行 / data 0.06MB + index 0.03MB。
-- company 表、columns 表、57 张业务表一律不动。
-- 3. 锁表风险:低。MySQL 8 的 MODIFY COLUMN 走 COPY 重建,但 users 是百行量级(V143 里同一条
-- MODIFY 实测执行 00:00.129s)。不碰 biz_task_file_job 等锁热点表。
-- 4. 验证 SQL:见文件末尾「验证」段。
-- 5. 回滚步骤:人工补丁,不写成版本化迁移(那样 Flyway 会在下次启动时自动执行)。
-- 顺序:停两台应用 → 执行
-- ALTER TABLE `users` MODIFY COLUMN `company_id` bigint NOT NULL DEFAULT 1
-- COMMENT '所属公司(company.id)';
-- → 删 flyway_schema_history 里 version='144' 那一行 → 回滚 jar → 起应用。
-- 漏掉删历史那步,将来重装时 Flyway 判定"已应用"而跳过,库与代码就长期不一致。
-- 6. 上线窗口:随 jar 双节点同窗口发布。摘掉 DEFAULT 后,混合版本窗口里旧 jar 的建号会报 1364
-- 而不是被静默塞进默认公司——这是取舍,不是缺陷。建号是后台管理员动作、无自助注册入口,
-- 两台背靠背重启把窗口压到分钟级即可接受。上线后核对该列 Default 必须是 NULL。
-- 若库里仍残留 DEFAULT(半套发布、老 dump 重建、手工 SET DEFAULT),启动期
-- CompanyDefaultGuard 会打 ASCII 签名 COMPANY_DEFAULT_STILL_PRESENT,巡检按它 grep。
--
-- 【可重跑性】本文件只有一条绝对形式的 ALTER ... MODIFY COLUMN:重复执行结果相同,
-- 不会报 1050/1060/1062,也不依赖 information_schema 判存在(列由 V143 建,Flyway 保证顺序)。
-- =============================================================
ALTER TABLE `users`
MODIFY COLUMN `company_id` bigint NOT NULL COMMENT '所属公司(company.id)';
-- =============================================================
-- 验证 SQL(迁移后在库上执行)
-- SHOW COLUMNS FROM `users` LIKE 'company_id';
-- -> 期望 Null = NO,Default = NULL(本迁移的全部目的就是让 Default 变 NULL;
-- Default 一旦还有值,不传公司的建号就会被静默塞进那一家)
-- SELECT COLUMN_NAME, COLUMN_DEFAULT, IS_NULLABLE
-- FROM information_schema.COLUMNS
-- WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'users' AND COLUMN_NAME = 'company_id';
-- -> 期望 COLUMN_DEFAULT 为 NULL、IS_NULLABLE = NO
-- SELECT COUNT(*) AS total, SUM(company_id IS NULL) AS null_company,
-- SUM(company_id = 1) AS in_xiamen_michunghua
-- FROM `users`;
-- -> 期望 null_company = 0 且 total = in_xiamen_michunghua(139 = 139)
-- SHOW INDEX FROM `users` WHERE Key_name = 'idx_users_company_id';
-- -> 期望 1 行(MODIFY 走 COPY 重建,索引必须还在)
-- SELECT COUNT(*) FROM `company`;
-- -> 期望 1(本迁移不动 company)
-- =============================================================