From e6c4c9e7cf42e9d0952e68d4306e859528beb91b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com>
Date: Sun, 4 Oct 2026 16:14:57 +0800
Subject: [PATCH] =?UTF-8?q?feat(=E5=85=AC=E5=8F=B8=E9=9A=94=E7=A6=BB):=20V?=
=?UTF-8?q?145=20=E7=BB=99=E4=B8=A4=E5=BC=A0=E8=A7=84=E5=88=99=E5=BA=93?=
=?UTF-8?q?=E8=A1=A8=E8=A1=A5=E5=BD=92=E5=B1=9E=EF=BC=8C=E5=94=AF=E4=B8=80?=
=?UTF-8?q?=E9=94=AE=E6=94=B9=E6=AF=8F=E5=85=AC=E5=8F=B8=E4=B8=80=E5=A5=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
品牌库/去重库原本没有公司这一列、唯一键是全局的,所以"每公司一套"无从谈起。
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 扫描路径会自己跑)。
---
backend-java/docs/migration-inventory.md | 15 +-
.../docs/rollback-V145-company-scope.sql | 36 ++
.../company/service/CompanyDefaultGuard.java | 76 +++-
.../db/V145__brand_dedupe_company_scope.sql | 215 +++++++++++
.../config/CompanyMigrationV144Test.java | 17 +-
.../config/CompanyScopeMigrationV145Test.java | 363 ++++++++++++++++++
.../service/CompanyDefaultGuardTest.java | 127 +++++-
7 files changed, 800 insertions(+), 49 deletions(-)
create mode 100644 backend-java/docs/rollback-V145-company-scope.sql
create mode 100644 backend-java/src/main/resources/db/V145__brand_dedupe_company_scope.sql
create mode 100644 backend-java/src/test/java/com/nanri/aiimage/config/CompanyScopeMigrationV145Test.java
diff --git a/backend-java/docs/migration-inventory.md b/backend-java/docs/migration-inventory.md
index 094d43dad..d38661379 100644
--- a/backend-java/docs/migration-inventory.md
+++ b/backend-java/docs/migration-inventory.md
@@ -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-04 随 V144 同步。
+> 快照日期:2026-10-01;2026-10-03 随 V142 追加时同步过概览数字与取号起点;2026-10-04 随 V143 同步;2026-10-04 随 V144 同步;2026-10-04 15:1x 随 V145 同步。
## 概览
-- 版本化迁移文件数:**143**(`src/main/resources/db/V*.sql`,其中整数版本 142 个 + 小版本 V25_1)
-- 整数版本范围:**V1..V144**,其中 V132/V133 为已退役空号(见下),其余连续
+- 版本化迁移文件数:**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 之前执行,属历史命名,保留)
-- 最新版本:**V144__users_company_id_drop_default.sql**(V142 已于 10-03 18:23 应用、V143 已于 10-04 10:48 应用;V144 待下一次 jar 发版执行)
+- 最新版本:**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`,无空格
@@ -20,18 +20,19 @@
本地曾存在 `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 永久退役,不可回填。
-后续新增迁移从 **V145** 起取号(只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,`integerVersionsSequentialFromOne` 会红)。
+后续新增迁移从 **V146** 起取号(只认"当前最大值 + 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` 实查)
+## 已应用迁移的存量校验和(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` 用工作树字节复算并比对过。
+这三行的字节就此封死。校验和算法是 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 前向修复,并把"已应用不许原地改"从注释升级成上面那条用例。
diff --git a/backend-java/docs/rollback-V145-company-scope.sql b/backend-java/docs/rollback-V145-company-scope.sql
new file mode 100644
index 000000000..83e3cdbab
--- /dev/null
+++ b/backend-java/docs/rollback-V145-company-scope.sql
@@ -0,0 +1,36 @@
+-- 回滚 V145(人工补丁,不放进 src/main/resources/db/——那里是 Flyway 扫描路径,
+-- 任何 V*.sql 都会在应用下次启动时自动执行;把回滚编成版本化迁移等于让"决定回滚"这件事
+-- 在没有人工执行的情况下自己发生。)
+--
+-- 顺序:停两台应用 → 执行本脚本 → DELETE FROM flyway_schema_history WHERE version='145'
+-- → 回滚 jar → 起应用。
+-- 漏掉"删历史行"那步,将来重装带 V145 的 jar 时 Flyway 判定"已应用"直接跳过,列与键都不会重建,
+-- 而 Java 侧实体照常读写 company_id ⇒ 运行期 Unknown column。
+--
+-- ⚠ 本脚本默认只做「保留新列、把唯一键退回全局」这一档。
+-- 退回全局唯一键要求"跨公司没有同名值"——批次 2(消费侧)上线之后这个前提不再由代码保证,
+-- 所以第二段是注释掉的,解开前先备份这两张表。
+-- 报 1062 说明确实已经有跨公司同名行:此时【不要】硬删数据,改走"保留新键、只回滚 jar"
+-- (新列对新 jar 是惰性的,不读写就不影响)。
+
+-- ---------- 1. 唯一键退回全局(先加旧键、后删新键,理由同 V145:中间任一步都至少有一个唯一键在守并发) ----------
+
+ALTER TABLE `biz_invalid_asin_data`
+ ADD UNIQUE KEY `uk_data_value_brand` (`data_value`, `brand`(191)),
+ ALGORITHM = INPLACE, LOCK = NONE;
+ALTER TABLE `biz_invalid_asin_data`
+ DROP INDEX `uk_company_value_brand`,
+ ALGORITHM = INPLACE, LOCK = NONE;
+
+ALTER TABLE `biz_dedupe_total_data`
+ ADD UNIQUE KEY `uk_data_value` (`data_value`),
+ ALGORITHM = INPLACE, LOCK = NONE;
+ALTER TABLE `biz_dedupe_total_data`
+ DROP INDEX `uk_company_data_value`,
+ ALGORITHM = INPLACE, LOCK = NONE;
+
+-- ---------- 2. 真的要把列也删掉才解开下面两行(不可逆,先备份) ----------
+-- company_id 上带着 50.7 万行的归属信息,一旦 DROP 就只能靠"全表填 1"重建,而第 2 家公司已经开通
+-- ⇒ 那次之后再也分不清哪一行属于谁。除非确认没有任何一行 company_id <> 1,否则不要执行。
+-- ALTER TABLE `biz_invalid_asin_data` DROP COLUMN `uploader_user_id`, DROP COLUMN `company_id`;
+-- ALTER TABLE `biz_dedupe_total_data` DROP COLUMN `company_id`;
diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/company/service/CompanyDefaultGuard.java b/backend-java/src/main/java/com/nanri/aiimage/modules/company/service/CompanyDefaultGuard.java
index e76c3d63f..9ee51e876 100644
--- a/backend-java/src/main/java/com/nanri/aiimage/modules/company/service/CompanyDefaultGuard.java
+++ b/backend-java/src/main/java/com/nanri/aiimage/modules/company/service/CompanyDefaultGuard.java
@@ -8,12 +8,19 @@ import org.springframework.context.event.EventListener;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Component;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
/**
- * 「半套发布」哨兵(设计文档 §6.3):第二家公司已经开通,但 {@code users.company_id} 还带着
- * {@code DEFAULT 1}——启动期打 ERROR。
+ * 「半套发布」哨兵(设计文档 §6.3 / §10 护栏 1):第二家公司已经开通,但带 {@code DEFAULT 1}
+ * 的 {@code company_id} 列还没摘掉默认值——启动期打 ERROR。
*
- *
这个组合不会报错、不会丢数据,只会让每个没显式传公司的建号被静默塞进默认那家(§8.2 里
- * DEFAULT 存在的唯一理由已经过去了)。正因为它安静,所以由代码来喊,而不是靠人记得。
+ * 这个组合不会报错、不会丢数据,只会让每个没显式传公司的写入被静默塞进默认那家(DEFAULT 存在的
+ * 唯一理由是发布期的旧 jar,§8.2 / V145 头注释)。正因为它安静,所以由代码来喊,而不是靠人记得。
+ *
+ * 盯的列随迁移增长:V143 给 {@code users} 加过一版(DEFAULT 已由 V144 摘),V145 给两张规则库
+ * 各加一版。一张表一行都插不进来的时候才是"摘干净",所以这里探的是【清单】而不是单个列名。
*
* 标记串({@link #ALARM} / {@link #PROBE_FAILED})是纯 ASCII:巡检脚本要在 docker logs 里
* grep 它,中文一旦在容器里变了编码就整条签名失效。
@@ -23,15 +30,23 @@ import org.springframework.stereotype.Component;
@Slf4j
public class CompanyDefaultGuard {
- /** 巡检签名用:出现即代表"多家公司已上线但 DEFAULT 未摘"。 */
+ /** 巡检签名用:出现即代表"多家公司已上线但 company_id 的 DEFAULT 未摘"。 */
public static final String ALARM = "COMPANY_DEFAULT_STILL_PRESENT";
/** 巡检签名用:哨兵自己没跑成(例如没有 information_schema 读权限),不能当成"检查过了"。 */
public static final String PROBE_FAILED = "COMPANY_DEFAULT_PROBE_FAILED";
+ /**
+ * 该带 company_id 且历史上可能被塞过 DEFAULT 的表。新增一列就要在这里登记一条——
+ * 漏登记的后果不是报错,是哨兵对着一个不存在的列一声不响({@link #check} 会把它当探不到处理)。
+ */
+ static final List WATCHED_TABLES = List.of(
+ "users", "biz_invalid_asin_data", "biz_dedupe_total_data");
+
private static final String COLUMN_DEFAULT_SQL = """
- SELECT COLUMN_DEFAULT FROM information_schema.COLUMNS
- WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'users' AND COLUMN_NAME = 'company_id'
+ SELECT TABLE_NAME, COLUMN_DEFAULT FROM information_schema.COLUMNS
+ WHERE TABLE_SCHEMA = DATABASE() AND COLUMN_NAME = 'company_id'
+ AND TABLE_NAME IN ('users', 'biz_invalid_asin_data', 'biz_dedupe_total_data')
""";
private final CompanyMapper companyMapper;
@@ -44,26 +59,57 @@ public class CompanyDefaultGuard {
void check() {
long companies;
- String columnDefault;
+ List