Files
knowledge-governance/cmd/worker/library_backup_reuse_test.go
T
姚章浩 85b3596e0e fix(postgres): 复用预备份时保留首次登记时刻
崩溃接管会复用崩溃前那份预备份;BackupPrepared 会再登记一次版本行,而
`created_at = EXCLUDED.created_at` 把"备份什么时候拍的"洗成了接管时刻 ——
事后无法区分"复用"和"崩溃后重做了备份",而后者正好把半写状态当成可回滚基线。

- 只对 `production_prebackup` 取 LEAST(首次登记时刻只早不晚);
- 生效版本行仍写当前时刻(重新激活一个旧快照后,页面要显示最近一次生效);
- 真实 PG 用例两条负例:撤掉保留规则 ⇒ 红;规则漏到所有 kind ⇒ 红。

verify: 一次性库 kg_takeover_reuse_test 上 PASS;
负例 1(撤掉 CASE)→ "复用后登记时刻被改写";负例 2(CASE 去掉 kind 条件)→
"生效版本重新激活后时刻";make verify overall success。
2026-10-30 07:56:12 +08:00

104 lines
4.7 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package main
import (
"context"
"testing"
"time"
"knowledge-governance/internal/governance"
"knowledge-governance/internal/libraryrelease"
)
// 接管复用的预备份必须是"同一份、且登记时刻不被洗掉":
// 崩溃后又重做一次备份会把半写状态当成可回滚基线,而 created_at 被重写
// 会让这两种情况在库里长得一模一样(演练脚本就判不出来了)。
//
// 只能在真实 PostgreSQL 上证明:这条语义写在 RecordLibraryVersion 的 upsert 里。
func TestPrebackupVersionKeepsFirstRegistrationTimeOnReuse(t *testing.T) {
store, _ := openLedgerStore(t)
ctx := context.Background()
const scope = "internal"
const snapshot = "snap-prebackup-reused"
first := time.Now().UTC().Add(-30 * time.Minute).Truncate(time.Second)
record := func(at time.Time, evidence map[string]any) {
t.Helper()
if err := store.RecordLibraryVersion(ctx, governance.LibraryVersion{
ID: governance.LibraryVersionID(governance.LibraryVersionProductionPrebackup, scope, snapshot),
Scope: scope, Kind: governance.LibraryVersionProductionPrebackup, SnapshotID: snapshot,
SourceJobID: "librestore-internal-resumed", CreatedBy: "worker",
Evidence: evidence, CreatedAt: at,
}); err != nil {
t.Fatalf("record prebackup at %s: %v", at, err)
}
}
record(first, map[string]any{"backup_snapshot": snapshot, "backup_bytes": 2048})
// 接管复用:BackupPrepared 会再登记一次(带 backup_reused),时刻是"现在"。
record(time.Now().UTC(), map[string]any{"backup_snapshot": snapshot, "backup_bytes": 2048,
"backup_reused": true})
version, found, err := store.LibraryVersionByRef(ctx, scope, governance.LibraryVersionProductionPrebackup,
"librestore-internal-resumed", snapshot)
if err != nil || !found {
t.Fatalf("read prebackup version: found=%t err=%v", found, err)
}
if !version.CreatedAt.UTC().Equal(first) {
t.Fatalf("复用后登记时刻被改写:%s, want %s(备份什么时候拍的被洗掉了)",
version.CreatedAt.UTC(), first)
}
if reused, _ := version.Evidence["backup_reused"].(bool); !reused {
t.Fatalf("复用的预览份没有 backup_reused=true:%v", version.Evidence)
}
// 反例对照:生效版本行的"重新激活"必须照旧写当前时刻 ——
// 上面那条 CASE 不许漏到别的 kind 上,否则恢复一个旧快照后
// 页面会把"最近一次生效"显示成很早以前。
const effectiveSnap = "snap-effective-reactivated"
effectiveAt := first.Add(time.Hour)
reactivatedAt := effectiveAt.Add(time.Hour)
for _, at := range []time.Time{effectiveAt, reactivatedAt} {
if err := store.RecordLibraryVersion(ctx, governance.LibraryVersion{
ID: governance.LibraryVersionID(governance.LibraryVersionProductionEffective, scope, effectiveSnap),
Scope: scope, Kind: governance.LibraryVersionProductionEffective, SnapshotID: effectiveSnap,
SourceJobID: "librestore-internal-reactivate", CreatedBy: "worker",
Evidence: map[string]any{"action": "restore"}, CreatedAt: at,
}); err != nil {
t.Fatalf("record effective at %s: %v", at, err)
}
}
effective, found, err := store.LibraryVersionByRef(ctx, scope, governance.LibraryVersionProductionEffective,
"librestore-internal-reactivate", effectiveSnap)
if err != nil || !found {
t.Fatalf("read effective version: found=%t err=%v", found, err)
}
if !effective.CreatedAt.UTC().Equal(reactivatedAt) {
t.Fatalf("生效版本重新激活后时刻 = %s, want %s(prebackup 的保留规则漏到别的 kind 上了)",
effective.CreatedAt.UTC(), reactivatedAt)
}
}
// ledgerBackupStore 复用预备份时必须显式带上 Reused 与持久写集合:
// 少了 Reused,证据里就分不清"复用"和"重做备份";少了写集合,恢复只能按
// 目标现状推断残渣(把历史/共享资源当残渣删掉的老缺陷)。
func TestLedgerBackupStoreMarksReuseAndCarriesWriteSet(t *testing.T) {
write := &libraryrelease.WriteSet{JobID: "librestore-internal-1", Target: "internal"}
store := ledgerBackupStore{
ref: libraryrelease.BackupRef{ID: "backup-snap-1", SnapshotID: "snap-1", Bytes: 4096},
write: write,
}
ref, err := store.Prepare(context.Background(), "target-snap", libraryrelease.CurrentState{})
if err != nil {
t.Fatalf("prepare: %v", err)
}
if !ref.Reused {
t.Fatal("复用预备份没有标 Reused:证据里分不清复用与重做备份")
}
if ref.SnapshotID != "snap-1" || ref.WriteSet != write {
t.Fatalf("复用的预备份身份/写集合被改:%+v", ref)
}
if _, err := (ledgerBackupStore{ref: ref}).Prepare(context.Background(), "t", libraryrelease.CurrentState{}); err == nil {
t.Fatal("没有写集合时必须失败(不许降级成按现状推断残渣)")
}
}