docs(debt): ④ 补两个伴随项 —— 重建表会丢具名索引 + 判据必须长在"迁移路径"上

pi（`b9c7308c`）提出，我逐条独立复现成立:

(i) 重建表丢掉具名索引:
    重建序列 新表→INSERT SELECT→DROP→RENAME ⇒ PK 真换了（功能对）
    但重建前索引 = sqlite_autoindex_aps_1 + idx_platform_sessions_ws
       重建后索引 = sqlite_autoindex_aps_1（**具名的没了**，RENAME 不带回）
    而该索引正是本条基石之一（"设计本来就 per-workspace"）:
      init_sqlite.sql:424 / init.sql:383  CREATE INDEX IF NOT EXISTS idx_platform_sessions_ws
   补救的现成条件: migrate 每次启动逐条重跑整份 init DDL，该 CREATE INDEX 与建表同批
     ⇒ 重建在这批 DDL **之前** ⇒ 索引当场补回（无窗口）
       重建在这批 DDL **之后** ⇒ 要等**下次启动**（窗口 = 本进程余生）
   我实测两个顺序确认 ⇒ 又一个顺序依赖（与 PK-先于-DELETE 同族）

(ii) 判据必须写成"迁移路径"测试:
    常规测试走 setupTestDB → t.TempDir() + Migrate = **全新建库** ⇒ 断言 PK 必然绿 ⇒ 抓不到生产
    只有「旧库 → Migrate → 断言实际 PK」才抓得到（pi 实测: 旧 PK 库 ⇒ 断言红）
    更便宜的补充: 启动自检（生产启动查 sqlite_master，PK 缺 workspace 即拒启/告警）
      —— 不需要测试基础设施，且生产上会响（测试永远不覆盖已部署库）
   ⇒ ④ 的判据两条并列: (a) 迁移路径断言实际 PK；(b) 断言 idx_platform_sessions_ws 存在

校验: go test ./internal/repo/ -run Debt -count=1 ⇒ ok（余额 27）

This commit is contained in:

JianFeeeee

2026-09-26 02:21:41 +08:00

parent b9a0bf57b3

commit 6a8e5dd16d

1 changed files with 2 additions and 2 deletions

4

docs/DEBTS.json

View File

File diff suppressed because one or more lines are too long

docs(debt): ④ 补两个伴随项 —— 重建表会丢具名索引 + 判据必须长在"迁移路径"上

4 docs/DEBTS.json View File

4

docs/DEBTS.json

View File