From 32a5dec5507effd3b7ee038c18b4f68c14a91d32 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Fri, 9 Oct 2026 12:19:45 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E8=BF=81=E7=A7=BB=E5=8F=B0=E8=B4=A6):=20V?= =?UTF-8?q?154=20=E8=90=BD=E6=A1=A3=E2=80=94=E2=80=94=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E6=95=B0=20152=E3=80=81=E8=8C=83=E5=9B=B4=20V1..V154=E3=80=81?= =?UTF-8?q?=E5=8F=96=E5=8F=B7=E8=B5=B7=E7=82=B9=E6=8E=A8=20to=20V155?= =?UTF-8?q?=EF=BC=8C=E6=91=98=20DEFAULT=20=E4=B8=80=E6=97=8F=E6=A0=87?= =?UTF-8?q?=E4=B8=BA=E6=91=98=E5=AE=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 两处红由仓库自己的纪律抓出来:MigrationInventoryTest 判"取号起点必须==磁盘最大值+1",CompanyMigrationV143Test 判文件数/上界/起点三处派生数字与磁盘一致 - V154 条目补上前提取证(只读探针:只剩这张带 DEFAULT 1;归属 546,344/8,125,无 0 无 NULL;孤儿 0;写侧上线后真实导入 29,555 行)与顺序约束(先上 Java 闸门的 jar,再让迁移随同版生效;反了会把静默归第 1 家换成静默归 0 家) - V152/V153 状态改为"已随 jar d1a3e8a2 双台应用"(启动日志实查 schema 153 / up to date) - 复跑 6 个读这份文档的用例类:71 例全绿 --- backend-java/docs/migration-inventory.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/backend-java/docs/migration-inventory.md b/backend-java/docs/migration-inventory.md index 6f78bcc63..7c50bd4ea 100644 --- a/backend-java/docs/migration-inventory.md +++ b/backend-java/docs/migration-inventory.md @@ -5,11 +5,11 @@ ## 概览 -- 版本化迁移文件数:**151**(`src/main/resources/db/V*.sql`,其中整数版本 150 个 + 小版本 V25_1) -- 整数版本范围:**V1..V153**,其中 V132/V133/V148 为已退役空号(见下),其余连续 +- 版本化迁移文件数:**152**(`src/main/resources/db/V*.sql`,其中整数版本 151 个 + 小版本 V25_1) +- 整数版本范围:**V1..V154**,其中 V132/V133/V148 为已退役空号(见下),其余连续 - 历史遗留小版本:**V25_1__shop_manage_group_bind_user.sql**(Flyway 语义 25.1,紧跟在 V25 之后、V26 之前执行,属历史命名,保留) -- 最新版本:**V153__shop_manage_group_company_id.sql**(上一版 **V152__columns_shop_key_company_id_drop_default.sql**,再上一版 **V151__rule_tables_shared_across_companies.sql**) -- 待下一次 jar 发版执行:**V152、V153**(V152 摘 `columns` 与 `biz_shop_key` 的 DEFAULT;V153 给分组表加 `company_id` 并把分组名从"全平台唯一"收窄成"同公司唯一",**写侧代码必须同批**,两个方向单独发都不行——见 V153 头注释第 6 段;V149/V150/V151 已于 10-06 17:32 应用,见下) +- 最新版本:**V154__biz_dedupe_total_data_company_id_drop_default.sql**(上一版 **V153__shop_manage_group_company_id.sql**,再上一版 **V152__columns_shop_key_company_id_drop_default.sql**) +- 待下一次 jar 发版执行:**V154**(V152、V153 已于 10-09 09:50 随 jar `69d2ebb0` 双台同版应用——启动日志实查 "Current version of schema `aiimage`: 153 / Schema `aiimage` is up to date. No migration necessary.";V149/V150/V151 已于 10-06 17:32 应用。V153 给分组表加 `company_id` 并把分组名从"全平台唯一"收窄成"同公司唯一",**写侧代码必须同批**,两个方向单独发都不行——见 V153 头注释第 6 段;V154 只摘一列的默认值,前提逐条取证见下面的 V154 条目) - 已应用:V142(10-03 18:23)、V143(10-04 10:48)、**V144(10-04 13:22)**、`V145__brand_dedupe_company_scope.sql`(10-05 13:01)、`V146__users_expires_at_admin_expiry.sql`(10-05 13:01)、**`V147__product_category_company_scope.sql`(10-06 11:03)**、`V149__permission_menu_company_tree.sql` / `V150__shop_key_company_scope.sql` / `V151__rule_tables_shared_across_companies.sql`(三条均为 10-06 17:32) - 末段 `flyway_schema_history` 为 2026-10-07 主机A 只读实查(`success` 全 1,最大整数版本 151),不是从 jar 版本推的 - 重复版本:无 @@ -25,9 +25,9 @@ `V148__product_category_builtin_owned_by_company.sql`(把 18 行内置类目的归属从共享哨兵 0 改成厦门米椿花 1)从未上线,2026-10-06 控制方点名「商品类目做成共享的,不区分」⇒ 它的口径被 V151 整体推翻,文件连同 `ProductCategoryMigrationV148Test`、`docs/rollback-V148-product-category-builtin-shared.sql` 一起删除。它与 132/133 的区别要写清:**把新迁移编号写回 148 在 Flyway 语义上是可行的**(生产最大值仍是 147,不存在 out-of-order),这里禁它是共树并发的护栏——148 与 149/150 是同一工作区里另一路会话此刻正在引用的号,被删的 `V148` 文件可能被再次写出,而同号两个文件会让 Flyway 启动期报 "Found more than one migration with version 148" ⇒ 两台 java 同时起不来。宁可让 `integerVersionsSequentialFromOne` 的红字出现在测试里,也不把撞号留到运行期发现。因此这三个号都在 `MigrationInventoryTest.RETIRED_HOLES` 里登记。 -后续新增迁移从 **V154** 起取号(V153 已被 `shop_manage_group_company_id` 占用:分组名从全平台唯一收窄到同公司唯一,回滚见 `docs/rollback-V153-shop-manage-group-company-id.sql`。只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,`integerVersionsSequentialFromOne` 会红;也不要回填上面那三个洞)。原先挂在 V149 名下的"摘 DEFAULT"待办,`columns` 那条已与 `biz_shop_key` 合并成 **V152** 发出(V150 头注释第 6 段要求"合并成一版发出";发布前的只读取证:`columns` 154 行按公司 52/51/51、`biz_shop_key` 16 行全 company_id=1 且无 NULL,两列 COLUMN_DEFAULT 都是 1)。摘 DEFAULT 这一族现在只剩一条: +后续新增迁移从 **V155** 起取号(V154 已被 `biz_dedupe_total_data_company_id_drop_default` 占用:只摘一列的默认值,回滚见 `docs/rollback-V154-dedupe-company-id-drop-default.sql`。只认"当前最大值 + 1",不要为还没写出来的迁移预留号段——预留会在 1..max 里留洞,`integerVersionsSequentialFromOne` 会红;也不要回填上面那三个洞)。原先挂在 V149 名下的"摘 DEFAULT"待办,`columns` 那条已与 `biz_shop_key` 合并成 **V152** 发出(V150 头注释第 6 段要求"合并成一版发出";发布前的只读取证:`columns` 154 行按公司 52/51/51、`biz_shop_key` 16 行全 company_id=1 且无 NULL,两列 COLUMN_DEFAULT 都是 1)。摘 DEFAULT 这一族到此摘完,最后一条是 **V154**: -- `ALTER TABLE biz_dedupe_total_data ALTER COLUMN company_id DROP DEFAULT;` —— 前提:写侧显式落列的修复(`insertBatchIgnore` 的列清单补 `company_id` + 实体加字段)**先上线并验证真实导入**。历史上它的导入不算这一列、全靠 `DEFAULT 1` 兜底,先摘=每次导入 1364;修复已落码、尚未出厂,按"先上线并验过写入 → 才谈摘"的顺序排下一版。 +- `ALTER TABLE biz_dedupe_total_data ALTER COLUMN company_id DROP DEFAULT;` —— 已作为 **V154** 发出。V152 当年把它留在门外的前提是"先修写侧、上线并验证真实导入之后才谈摘",2026-10-09 只读探针(运维仓 `scripts/_probe_dedupe_default.py`,主机A,零写入)逐条对上:哨兵四张表里只剩这张仍带 DEFAULT 1(users / biz_shop_key / columns 的 COLUMN_DEFAULT 均为空);归属分布 company_id=1 共 546,344 行、=3 共 8,125 行,**没有 0 也没有 NULL**;孤儿归属 0 行;写侧显式落值那版上线后真实导入 29,555 行(2026-10-07 09:48:38 → 2026-10-08 23:57:51)。⚠ 本表批量导入走 `INSERT IGNORE`:在生产 sql_mode(实查含 STRICT_TRANS_TABLES)下省略该列不会撞 1364,而是被降级成 warning 并落成隐式默认 **0**——0 不属于任何公司,行插得进去但对所有公司隐形,比"静默归第 1 家"更难发现。⇒ **顺序必须是先上带 Java 闸门的 jar,再让本迁移随同一版生效**;闸门=`DedupeTotalDataService.requireCompanyAttribution`(接在 create 与 insertImportBatch 两条写通道上),用例 `DedupeTotalDataWriteAttributionTest` 4 例,其中接线钉按行首语句数调用点==2(避开 javadoc 同名提及那个坑)。 **`biz_product_category.company_id` 的 DEFAULT 由"待摘"改成"必须保留"**(这一条与 V151 同批生效):V151 之后新 jar 的 INSERT 列清单不含 `company_id`,而该列是 `NOT NULL`,全靠 `DEFAULT 1` 满足——此时执行 `DROP DEFAULT` 会让每一次新建类目报 1364。`biz_invalid_asin_data.company_id` 同理(品牌库那条写入失败还会被 `CollectDataInvalidAsinBatchWriter` 吞成 `log.warn` ⇒ 接口返回成功而黑名单静默少一批)。所以这两张表已从 `CompanyDefaultGuard.WATCHED_TABLES` 与探针 SQL 的 IN 列表里同时摘掉(清单与 SQL 由 `CompanyDefaultGuardTest` 双向钉同源),否则哨兵会在每次启动时对着一列"没人读、摘了会炸"的默认值喊 `COMPANY_DEFAULT_STILL_PRESENT`,而巡检把那条签名计进 ALERTS。 它们真正消失的时点是下一版(两台同版之后): @@ -35,7 +35,7 @@ - `ALTER TABLE biz_invalid_asin_data DROP COLUMN company_id;` - `ALTER TABLE biz_product_category DROP COLUMN company_id;` -摘除 DEFAULT 的动作在这两条里"顺带完成"(列没了,默认值随之消失),**仍然禁写成 `MODIFY COLUMN ... NOT NULL`**(重建表会按当时的列默认值物化历史行)。`biz_shop_key` 已在 **V152** 摘掉 DEFAULT(哨兵清单保留:被装回时会再喊出来);`biz_dedupe_total_data` 仍按公司写、DEFAULT 待摘(等写侧修复上线),哨兵继续盯。 +摘除 DEFAULT 的动作在这两条里"顺带完成"(列没了,默认值随之消失),**仍然禁写成 `MODIFY COLUMN ... NOT NULL`**(重建表会按当时的列默认值物化历史行)。`biz_shop_key` 已在 **V152** 摘掉 DEFAULT,`biz_dedupe_total_data` 已在 **V154** 摘掉——两张的哨兵清单都原样保留:哪天默认值被 dump 重建或手滑装回,启动期还能再喊出来。 原先挂在待办里的"V137 冗余索引 DROP"迁移计划取 V139,该号已被 `V139__asin_result_cache.sql` 占用,顺延到 V140;V140 已被品牌补测队列表 `V140__collectdata_brand_recheck.sql` 落用。