Part of #88 ## Question `__drizzle_migrations` 账本语义(hash 算法、folderMillis、`src/lib/db/migrations.ts` 里 0017-0019 半迁移修复逻辑)在 Go 侧如何兼容:byte-compatible 执行同一批 41 个 SQL 文件(含修复逻辑移植)的代价 vs 冻结 schema 只读校验?未来新增迁移用什么工具(golang-migrate / 手写 / 继续 drizzle-kit 生成 SQL)?与 modernc.org/sqlite 的并发/WAL 交互有无坑?
Activity
JonasGao commentedon Nov 5, 2026
结论
采用 B+:冻结基线 + 启动严格校验 + 同账本“顺序前缀 applier”(仅放在显式
wr db migrate)。serve启动时只读校验账本与 schema,到 head(41/41)才服务;不满足即 fail closed,绝不执行迁移 SQL。max(created_at)游标(有已知倒序跳过 bug),也不把 0017–0019 修复逻辑放进启动路径(健康库上全是 no-op,只保留为旧库/旧备份的一次性升级入口)。drizzle/ + meta/_journal.json + __drizzle_migrations,由 Go 手写 tiny applier 按 journal 顺序应用;不引入 golang-migrate/goose 的第二套账本。关键发现(会推翻“hash 全等即可校验”的假设)
实测生产库 41 行账本并非逐条 hash 匹配:
0002–0010是 16 字符旧格式 hash;其中0002的 hash 对应 commit9a7e847重写前的文件内容,当前文件永远算不出来。0001–0010的created_at是旧版“应用时刻”,不等于 journal 的when。when倒序(0003、0018、0029),朴素复刻 drizzle 判定会静默跳过条目。因此启动校验必须带历史例外表(完整 sha256 / 前 16 位 /
created_at == when/ 0002 固定旧 hash),并配合 schema 哨兵。其他
_pragma=foreign_keys(1)(对齐 better-sqlite3 编译默认)、_pragma=busy_timeout(5000)、_pragma=journal_mode(WAL)、有界SetMaxOpenConns;WAL 单写者 + 读者并发,备份需处理-wal/-shm。go:embed目录模式会排除_开头文件,需显式drizzle/meta/_journal.json或 glob;embed pattern 不能含..,建议在仓库根放 embed 包。Findings:
docs/research/drizzle-journal-compat.md,分支research/drizzle-journal-compat,commit3e4aa23。文件内含精确的启动序列、wr db migrate算法、Option A/B 对比与全部证据引用。