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:
@@ -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-04 随 V143 同步。
|
||||
> 快照日期:2026-10-01;2026-10-03 随 V142 追加时同步过概览数字与取号起点;2026-10-04 随 V143 同步;2026-10-04 随 V144 同步。
|
||||
|
||||
## 概览
|
||||
|
||||
- 版本化迁移文件数:**142**(`src/main/resources/db/V*.sql`,其中整数版本 141 个 + 小版本 V25_1)
|
||||
- 整数版本范围:**V1..V143**,其中 V132/V133 为已退役空号(见下),其余连续
|
||||
- 版本化迁移文件数:**143**(`src/main/resources/db/V*.sql`,其中整数版本 142 个 + 小版本 V25_1)
|
||||
- 整数版本范围:**V1..V144**,其中 V132/V133 为已退役空号(见下),其余连续
|
||||
- 历史遗留小版本:**V25_1__shop_manage_group_bind_user.sql**(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留)
|
||||
- 最新版本:**V143__company_and_users_company_id.sql**(V141 已于 2026-10-03 随 jar 上线两台;V142/V143 待下一次发版执行)
|
||||
- 最新版本:**V144__users_company_id_drop_default.sql**(V142 已于 10-03 18:23 应用、V143 已于 10-04 10:48 应用;V144 待下一次 jar 发版执行)
|
||||
- 重复版本:无
|
||||
- 迁移命名:全部符合 `V<整数>(_<子版本>)?__<描述>.sql`,无空格
|
||||
|
||||
@@ -20,10 +20,21 @@
|
||||
|
||||
本地曾存在 `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 永久退役,不可回填。
|
||||
|
||||
后续新增迁移从 **V144** 起取号(只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,`integerVersionsSequentialFromOne` 会红)。
|
||||
后续新增迁移从 **V145** 起取号(只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,`integerVersionsSequentialFromOne` 会红)。
|
||||
|
||||
原先挂在待办里的"V137 冗余索引 DROP"迁移计划取 V139,该号已被 `V139__asin_result_cache.sql` 占用,顺延到 V140;V140 已被品牌补测队列表 `V140__collectdata_brand_recheck.sql` 落用。
|
||||
|
||||
## 已应用迁移的存量校验和(2026-10-04 11: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 |
|
||||
|
||||
这两行的字节就此封死。校验和算法是 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}` 内的号段除外)、无重复文件名、命名正则合规、历史文件校验和可复算稳定。
|
||||
|
||||
@@ -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)
|
||||
-- =============================================================
|
||||
@@ -168,8 +168,9 @@ class CompanyMigrationV143Test {
|
||||
assertEquals(143, versionOf(file), "多公司迁移必须是 V143(V142 之后的下一号)");
|
||||
assertTrue(file.getFileName().toString().matches("^V143__[A-Za-z0-9_.-]+$"),
|
||||
"命名应 V143__<snake 描述>.sql: " + file.getFileName());
|
||||
assertEquals(maxVersionOnDisk(), 143,
|
||||
"V143 必须是当前最大版本;若磁盘上已有更大的号,说明本迁移被插到了历史中间");
|
||||
// 这里原本还断言"V143 必须是当前最大版本"。V143 已在 2026-10-04 10:48 落库、字节封死,
|
||||
// 后续口径变更只能写成 V144 及以后 ⇒ 那条断言变成了假前提。号段连续性与撞号仍由
|
||||
// MigrationInventoryTest(integerVersionsSequentialFromOne / 无重复文件名)把守。
|
||||
}
|
||||
|
||||
/** 破坏点:头注释缺项 → 上线评审拿不到锁表风险与回滚口径。 */
|
||||
|
||||
@@ -0,0 +1,286 @@
|
||||
package com.nanri.aiimage.config;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import java.io.BufferedReader;
|
||||
import java.io.IOException;
|
||||
import java.io.StringReader;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
import java.util.regex.Matcher;
|
||||
import java.util.regex.Pattern;
|
||||
import java.util.stream.Stream;
|
||||
import java.util.zip.CRC32;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||
|
||||
/**
|
||||
* V144(摘掉 users.company_id 的列默认值)与「已应用迁移字节封死」契约。
|
||||
* 设计:crawler-plugin/docs/ops/company-multi-tenant-design-2026-10-04.md §6.3 / §8.2。
|
||||
*
|
||||
* <p>背景:V143 出厂时带 {@code NOT NULL DEFAULT 1}(为混合版本窗口的旧 jar 兜底),
|
||||
* 2026-10-04 10:48:54 已被应用到生产库。定案是「归属只由回填与 createUser 显式决定,
|
||||
* 宁可撞 MySQL 1364 也不要静默归错公司」,所以 DEFAULT 必须摘——但**不能原地改 V143**:
|
||||
* Flyway 的 {@code validate-on-migrate} 是硬编码 true,改动已应用迁移的字节会让下一次
|
||||
* 重启在启动期报校验和不匹配,两台都起不来。摘除只能写成 V144 前向修复。</p>
|
||||
*
|
||||
* <p>与 {@link CompanyMigrationV143Test} 同口径:断言打在剥掉注释后的可执行 SQL 上,
|
||||
* 本仓无 H2 / testcontainers,迁移不能真跑,所以文件审计是唯一能守住的层。</p>
|
||||
*/
|
||||
class CompanyMigrationV144Test {
|
||||
|
||||
private static final Path ROOT = Path.of(System.getProperty("user.dir"));
|
||||
private static final Path DB_DIR = ROOT.resolve("src/main/resources/db");
|
||||
private static final Pattern VERSION_FILE = Pattern.compile("^V(\\d+)(?:_(\\d+))?__.*\\.sql$");
|
||||
|
||||
/**
|
||||
* 生产库 flyway_schema_history 的存量校验和(2026-10-04 11:0x 只读实查,主机A 业务库)。
|
||||
* 这两个号已经被应用,字节就此封死;改一个空格都会让下次重启启动期校验失败。
|
||||
*/
|
||||
private record Applied(String fileName, int prodChecksum) {
|
||||
}
|
||||
|
||||
private static final List<Applied> APPLIED_IN_PROD = List.of(
|
||||
new Applied("V142__web_config_sha256.sql", 1152261840),
|
||||
new Applied("V143__company_and_users_company_id.sql", 1539570901));
|
||||
|
||||
// ---------------------------------------------------------------- 取文件
|
||||
|
||||
private static List<Path> versionFiles() throws IOException {
|
||||
try (Stream<Path> s = Files.list(DB_DIR)) {
|
||||
return s.filter(p -> VERSION_FILE.matcher(p.getFileName().toString()).matches())
|
||||
.sorted()
|
||||
.toList();
|
||||
}
|
||||
}
|
||||
|
||||
private static int versionOf(Path p) {
|
||||
Matcher m = VERSION_FILE.matcher(p.getFileName().toString());
|
||||
return m.matches() ? Integer.parseInt(m.group(1)) : -1;
|
||||
}
|
||||
|
||||
private static Path migration() throws IOException {
|
||||
List<Path> hits = versionFiles().stream()
|
||||
.filter(p -> p.getFileName().toString().startsWith("V144__"))
|
||||
.toList();
|
||||
assertFalse(hits.isEmpty(), "缺少 V144__*.sql:摘 DEFAULT 的前向修复还没落盘");
|
||||
assertEquals(1, hits.size(), "V144 只允许一个迁移文件(撞号会让 Flyway 启动失败)");
|
||||
return hits.get(0);
|
||||
}
|
||||
|
||||
private static Path fileNamed(String fileName) {
|
||||
return DB_DIR.resolve(fileName);
|
||||
}
|
||||
|
||||
private static String raw(Path file) throws IOException {
|
||||
return Files.readString(file, StandardCharsets.UTF_8);
|
||||
}
|
||||
|
||||
private static String rawMigration() throws IOException {
|
||||
return raw(migration());
|
||||
}
|
||||
|
||||
private static String statements() throws IOException {
|
||||
return normalize(stripComments(rawMigration()));
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------ SQL 预处理
|
||||
|
||||
/** 去掉 -- 行注释与块注释,保留单引号字符串字面量(避免把字面量里的 -- 当注释吃掉)。 */
|
||||
private static String stripComments(String sql) {
|
||||
StringBuilder out = new StringBuilder(sql.length());
|
||||
int i = 0;
|
||||
while (i < sql.length()) {
|
||||
char c = sql.charAt(i);
|
||||
if (c == '\'') {
|
||||
int end = i + 1;
|
||||
while (end < sql.length()) {
|
||||
if (sql.charAt(end) == '\'') {
|
||||
if (end + 1 < sql.length() && sql.charAt(end + 1) == '\'') {
|
||||
end += 2;
|
||||
continue;
|
||||
}
|
||||
break;
|
||||
}
|
||||
end++;
|
||||
}
|
||||
out.append(sql, i, Math.min(end + 1, sql.length()));
|
||||
i = end + 1;
|
||||
continue;
|
||||
}
|
||||
if (c == '-' && i + 1 < sql.length() && sql.charAt(i + 1) == '-') {
|
||||
while (i < sql.length() && sql.charAt(i) != '\n') {
|
||||
i++;
|
||||
}
|
||||
continue;
|
||||
}
|
||||
if (c == '/' && i + 1 < sql.length() && sql.charAt(i + 1) == '*') {
|
||||
int end = sql.indexOf("*/", i + 2);
|
||||
i = end < 0 ? sql.length() : end + 2;
|
||||
continue;
|
||||
}
|
||||
out.append(c);
|
||||
i++;
|
||||
}
|
||||
return out.toString();
|
||||
}
|
||||
|
||||
private static String normalize(String sql) {
|
||||
return sql.replaceAll("\\s+", " ").trim();
|
||||
}
|
||||
|
||||
/**
|
||||
* Flyway 的校验和:CRC32 逐 {@code BufferedReader.readLine()} 的 UTF-8 字节累加,
|
||||
* 行尾不入 CRC(所以 CRLF 树与 LF 树算出同一个值)。用生产库 142/143 的存量值反证过。
|
||||
*/
|
||||
private static int flywayChecksum(String content) throws IOException {
|
||||
CRC32 crc = new CRC32();
|
||||
try (BufferedReader reader = new BufferedReader(new StringReader(content))) {
|
||||
String line;
|
||||
while ((line = reader.readLine()) != null) {
|
||||
crc.update(line.getBytes(StandardCharsets.UTF_8));
|
||||
}
|
||||
}
|
||||
return (int) crc.getValue();
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------------ 用例
|
||||
|
||||
/**
|
||||
* 破坏点:原地改一个已经应用到生产库的迁移。V143 在 10:48 已落库,本次差点把它的闸门句
|
||||
* 就地改成不带 DEFAULT——那样 jar 里的字节与 flyway_schema_history.checksum 不等,
|
||||
* 而 {@code spring.flyway.validate-on-migrate=true} 是硬编码 ⇒ 下一次重启启动期直接失败,
|
||||
* 两台 java 都起不来。这条用例把"已应用"这件事变成代码能拦的东西。
|
||||
*/
|
||||
@Test
|
||||
void appliedMigrationBytesAreFrozenAgainstProdChecksum() throws IOException {
|
||||
for (Applied applied : APPLIED_IN_PROD) {
|
||||
Path file = fileNamed(applied.fileName());
|
||||
assertTrue(Files.isRegularFile(file), "已应用迁移应仍在扫描路径内:" + applied.fileName());
|
||||
int computed = flywayChecksum(raw(file));
|
||||
assertEquals(applied.prodChecksum(), computed,
|
||||
applied.fileName() + " 已经应用到生产库(校验和钉在 flyway_schema_history),"
|
||||
+ "原地改它的字节会让下次启动 Flyway 校验失败、两台都起不来。"
|
||||
+ "要改口径就写下一条迁移(V144 就是这么来的)。");
|
||||
}
|
||||
}
|
||||
|
||||
/** 破坏点:取号取到已应用的 143(原地改)或取到退役洞 132/133,Flyway 启动期撞号或报未应用。 */
|
||||
@Test
|
||||
void migrationIsVersionedOneFourFour() throws IOException {
|
||||
Path file = migration();
|
||||
assertEquals(144, versionOf(file), "摘 DEFAULT 必须是 V144(V143 之后的下一号,不能原地改 V143)");
|
||||
assertTrue(file.getFileName().toString().matches("^V144__[A-Za-z0-9_.-]+$"),
|
||||
"命名应 V144__<snake 描述>.sql: " + file.getFileName());
|
||||
int maxOnDisk = versionFiles().stream().mapToInt(CompanyMigrationV144Test::versionOf).max().orElse(0);
|
||||
assertEquals(144, maxOnDisk, "V144 应是当前最大版本");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:V144 没把 DEFAULT 摘干净(写成 ADD COLUMN 或又补回 DEFAULT 1)。
|
||||
* 留着默认值的后果不是"多一个 1",而是任何绕过 createUser 的写入被静默塞进厦门米椿花——
|
||||
* 第二家公司开通后这就是归属失真,且一声不响。
|
||||
*/
|
||||
@Test
|
||||
void v144DropsTheColumnDefault() throws IOException {
|
||||
String sql = statements();
|
||||
Matcher gate = Pattern.compile("ALTER TABLE `users`\\s+MODIFY COLUMN `company_id`[^;]*;").matcher(sql);
|
||||
assertTrue(gate.find(), "应有 MODIFY COLUMN company_id 的语句(未匹配到,可能写法改了)");
|
||||
String clause = gate.group();
|
||||
assertTrue(clause.toUpperCase().contains("NOT NULL"), "MODIFY 应保持 NOT NULL,否则回填漏行不再被闸门拦下");
|
||||
assertFalse(clause.toUpperCase().contains("DEFAULT"),
|
||||
"MODIFY 后不得再出现 DEFAULT(本迁移的唯一目的就是摘掉它): " + clause);
|
||||
assertTrue(rawMigration().contains("1364"),
|
||||
"头注释应写清「宁可撞 MySQL 1364 也不静默归错公司」的取舍,否则后人会把 DEFAULT 当漏配加回来");
|
||||
assertTrue(rawMigration().contains("V143"), "头注释应点名 DEFAULT 来自 V143,说明这是前向修复而非补漏");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:顺手把 users 改回可空、或删列、或动了别的表。
|
||||
* 一期定案是业务表零 DDL + company_id NOT NULL;V144 只该改这一列的默认值属性。
|
||||
*/
|
||||
@Test
|
||||
void v144TouchesOnlyUsersCompanyIdAndIsRerunnable() throws IOException {
|
||||
String sql = statements();
|
||||
|
||||
List<String> altered = new ArrayList<>();
|
||||
Matcher alter = Pattern.compile("ALTER TABLE `([A-Za-z0-9_]+)`").matcher(sql);
|
||||
while (alter.find()) {
|
||||
altered.add(alter.group(1));
|
||||
}
|
||||
assertFalse(altered.isEmpty(), "应有 ALTER TABLE(否则上一条断言是被注释喂绿的)");
|
||||
assertEquals(List.of("users"), altered.stream().distinct().toList(),
|
||||
"V144 只允许改 users,实际改到了 " + altered);
|
||||
|
||||
assertFalse(sql.contains("CREATE TABLE"), "V144 不该建新表");
|
||||
assertFalse(Pattern.compile("DROP\\s+(TABLE|COLUMN|INDEX)").matcher(sql).find(),
|
||||
"V144 是前向修复,不是回滚:不得出现 DROP TABLE/COLUMN/INDEX");
|
||||
assertFalse(sql.contains("ADD COLUMN"),
|
||||
"company_id 已由 V143 建好,这里再 ADD COLUMN 重跑必报 1060");
|
||||
}
|
||||
|
||||
/** 破坏点:头注释缺项 → 上线评审拿不到锁表风险与回滚口径,也看不出这笔与 V143 的关系。 */
|
||||
@Test
|
||||
void v144HeaderCarriesTemplateFieldsAndWhyItExists() throws IOException {
|
||||
String raw = rawMigration();
|
||||
assertTrue(raw.contains("V144"), "头注释应标明迁移版本 V144");
|
||||
for (int i = 1; i <= 6; i++) {
|
||||
assertTrue(raw.contains(i + ". "), "头注释应含模板第 " + i + " 项必填");
|
||||
}
|
||||
for (String field : List.of("变更目的", "影响表与数据量", "锁表风险", "验证 SQL", "回滚步骤", "上线窗口")) {
|
||||
assertTrue(raw.contains(field), "头注释应含必填项:" + field);
|
||||
}
|
||||
assertTrue(raw.contains("已应用"), "头注释应说明 V143 已被应用、因此只能前向修复");
|
||||
assertTrue(raw.contains("校验和") || raw.contains("checksum"),
|
||||
"头注释应说明为什么不能原地改 V143(Flyway 校验和)");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:没留验证 SQL。这笔迁移的成败只体现在列属性上——启动日志里"Successfully applied"
|
||||
* 与"DEFAULT 摘干净"是两件事,只能靠 SHOW COLUMNS 的 Default 列复核。
|
||||
*/
|
||||
@Test
|
||||
void v144ShipsPostDeployVerificationSql() throws IOException {
|
||||
String raw = rawMigration();
|
||||
assertTrue(raw.contains("验证 SQL"), "头注释应含「验证 SQL」段(模板第 4 项)");
|
||||
assertTrue(raw.contains("SHOW COLUMNS FROM `users` LIKE 'company_id'")
|
||||
|| raw.contains("SHOW COLUMNS FROM users LIKE 'company_id'"),
|
||||
"验证 SQL 应核对 company_id 的 Null / Default");
|
||||
assertTrue(raw.contains("Default = NULL"),
|
||||
"验证 SQL 应把期望写成 Default = NULL,否则验收的人无从判断摘没摘");
|
||||
}
|
||||
|
||||
/**
|
||||
* 破坏点:哨兵被当成历史包袱删掉。V144 上线后 DEFAULT 本应不存在,
|
||||
* 但库里仍可能有(半套发布、老 dump 重建、手工 SET DEFAULT)——那是 §6.3 唯一的自动出口。
|
||||
*/
|
||||
@Test
|
||||
void defaultSentinelStillShipsAndStaysWired() throws IOException {
|
||||
Path guard = ROOT.resolve("src/main/java/com/nanri/aiimage/modules/company/service/CompanyDefaultGuard.java");
|
||||
assertTrue(Files.isRegularFile(guard), "启动期 DEFAULT 哨兵应存在:" + guard);
|
||||
String text = raw(guard);
|
||||
assertTrue(text.contains("COMPANY_DEFAULT_STILL_PRESENT"),
|
||||
"哨兵标记串必须保持 ASCII 原样(巡检脚本按它在 docker logs 里 grep)");
|
||||
assertTrue(text.contains("COLUMN_DEFAULT") || text.contains("information_schema"),
|
||||
"哨兵应真的读列元数据,而不是靠猜");
|
||||
assertTrue(rawMigration().contains("COMPANY_DEFAULT_STILL_PRESENT"),
|
||||
"V144 头注释应点名哨兵签名,上线后才能把「响没响」当验收项");
|
||||
}
|
||||
|
||||
/** 破坏点:盘点文档没跟着 V144 改,下一个人按"取号起点"取号就撞号。 */
|
||||
@Test
|
||||
void inventoryDocTracksV144() throws IOException {
|
||||
Path doc = ROOT.resolve("docs/migration-inventory.md");
|
||||
assertTrue(Files.isRegularFile(doc), "盘点文档应存在");
|
||||
String text = Files.readString(doc, StandardCharsets.UTF_8);
|
||||
assertTrue(text.contains(migration().getFileName().toString()),
|
||||
"盘点文档应记录 V144 文件名 " + migration().getFileName());
|
||||
assertTrue(text.contains("1539570901"),
|
||||
"盘点文档应记下 V143 的生产存量校验和,作为「不许原地改」的证据");
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user