fix: 修复不完整的商品目录迁移 (#144)

2026-08-11 11:26:40 +08:00
parent cc595c164e
commit fef97cf5f3
4 changed files with 120 additions and 3 deletions
@@ -87,11 +87,15 @@ HTTP/HTTPS URL，最长 2048 字节；店铺名最长 500 个字符。Admin 只
 调用方应按 `code` 处理，不要解析中文 `message`。校验错误通常是 400/422，业务冲突
 是 409，临时服务错误是 500/503。响应和导入记录都不会回显 Token 或完整请求体。

-## 5. schema v8 发布与回退
+## 5. schema v8～v10 发布与回退

-发布前先备份生产库，并在 MySQL 8.4、库名以 `_test` 结尾的测试库演练 v7→v8→v9。
+发布前先备份生产库，并在 MySQL 8.4、库名以 `_test` 结尾的测试库演练 v7→v8→v9→v10。
 迁移只增加列和唯一索引，既有 `sku_id` 继续作为内部主键，因此历史引用不变；若检测
 到同商品重复 `spec_key`，迁移会停止且不记录 v8，必须人工确认，不能自动合并。

+若数据库已经记录 v8 或 v9，但缺少 `field_sources`、`field_observed_at` 等后加入的
+v8 结构，v10 会自动补齐并只回填空值。不要通过删除迁移版本、清库或手工伪造字段来
+绕过自检；修复完成且 v8/v9 形状均正确后，程序才会记录 v10。
+
 旧版 Admin 不理解无真实 SKU ID 的新记录。应用回退前应暂停目录接口并确认没有此类
 记录；不要删除 v8 列或把内部主键复制成伪造的外部 SKU ID。