Download internal/credithist/fault_test.go from a3216/gcli2api: direct link, hf CLI and curl.
- Browser
- Download file 14.8 kB
-
https://huggingface.co/spaces/a3216/gcli2api/resolve/main/internal/credithist/fault_test.go
- Command line
-
hf download hf://spaces/a3216/gcli2api/internal/credithist/fault_test.go
-
curl -L -o fault_test.go https://huggingface.co/spaces/a3216/gcli2api/resolve/main/internal/credithist/fault_test.go
14.8 kB
| package credithist | |
| // T5 故障注入与边界测试(账本层)。只新增测试,不改业务代码。 | |
| import ( | |
| "fmt" | |
| "os" | |
| "path/filepath" | |
| "runtime" | |
| "sync" | |
| "testing" | |
| ) | |
| // ── 1. 落盘目标不可写 ────────────────────────────────────────────────────── | |
| // 目标路径任何一段不可写(这里用「父路径是普通文件」构造,Windows / POSIX 都成立) | |
| // 时,Observe 只能记日志:不得 panic、不得影响内存账本;故障排除后必须恢复落盘。 | |
| func TestFaultUnwritableTargetKeepsMemoryAndRecovers(t *testing.T) { | |
| dir := t.TempDir() | |
| blocker := filepath.Join(dir, "blocker") | |
| if err := os.WriteFile(blocker, []byte("x"), 0o600); err != nil { | |
| t.Fatal(err) | |
| } | |
| path := filepath.Join(blocker, "credit-history.json") // 父路径是普通文件 → MkdirAll 与写盘必失败 | |
| l := New(path, 100) | |
| l.Observe("u1", 100) // 基线:落盘失败 | |
| l.Observe("u1", 250) // +150:落盘失败 | |
| got := l.Read(0) | |
| if len(got) != 1 || got[0].Delta != 150 || got[0].After != 250 { | |
| t.Fatalf("落盘失败不应影响内存账本,得到 %+v", got) | |
| } | |
| if l.snapshot["u1"] != 250 { | |
| t.Fatalf("内存基线应为 250,得到 %d", l.snapshot["u1"]) | |
| } | |
| if _, err := os.Stat(path); err == nil { | |
| t.Fatal("父路径是普通文件时不应写出账本文件") | |
| } | |
| // 排除故障:删掉阻塞文件、建同名目录,再观察必须恢复落盘。 | |
| if err := os.Remove(blocker); err != nil { | |
| t.Fatal(err) | |
| } | |
| if err := os.Mkdir(blocker, 0o755); err != nil { | |
| t.Fatal(err) | |
| } | |
| l.Observe("u1", 300) // +50 | |
| l2 := New(path, 100) | |
| got = l2.Read(0) | |
| if len(got) != 2 || got[0].Delta != 50 || got[1].Delta != 150 { | |
| t.Fatalf("恢复可写后应落盘并保留两条流水,得到 %+v", got) | |
| } | |
| if l2.snapshot["u1"] != 300 { | |
| t.Fatalf("恢复后快照应为 300,得到 %d", l2.snapshot["u1"]) | |
| } | |
| } | |
| // POSIX 目录只读路径。Windows 的 os.Chmod 只改文件只读属性,没有目录写保护语义, | |
| // 故在 Windows 上跳过(不可写路径已由上面的父路径为文件用例覆盖)。 | |
| func TestFaultReadOnlyDirPOSIX(t *testing.T) { | |
| if runtime.GOOS == "windows" { | |
| t.Skip("Windows 无 POSIX 目录权限语义") | |
| } | |
| if os.Geteuid() == 0 { | |
| t.Skip("root 不受目录权限限制") | |
| } | |
| dir := t.TempDir() | |
| sub := filepath.Join(dir, "ro") | |
| if err := os.Mkdir(sub, 0o755); err != nil { | |
| t.Fatal(err) | |
| } | |
| path := filepath.Join(sub, "credit-history.json") | |
| l := New(path, 100) | |
| l.Observe("u1", 10) // 正常落盘 | |
| if err := os.Chmod(sub, 0o500); err != nil { | |
| t.Fatal(err) | |
| } | |
| l.Observe("u1", 20) // 写临时文件失败 → 只记日志 | |
| if got := l.Read(0); len(got) != 1 || got[0].Delta != 10 { | |
| t.Fatalf("只读目录下内存账本仍应正确,得到 %+v", got) | |
| } | |
| if err := os.Chmod(sub, 0o755); err != nil { | |
| t.Fatal(err) | |
| } | |
| l.Observe("u1", 30) | |
| l2 := New(path, 100) | |
| if got := l2.Read(0); len(got) != 2 || got[1].Delta != 10 { | |
| t.Fatalf("恢复可写后应落盘两条,得到 %+v", got) | |
| } | |
| } | |
| // ── 2. 退化/损坏文件 ────────────────────────────────────────────────────── | |
| // 损坏 JSON、null 快照/流水、空文件、类型不符、顶层数组、路径本身是目录—— | |
| // 一律从空账本安全启动,后续 Observe 正常,不得 panic。 | |
| func TestFaultDegenerateFilesStartEmpty(t *testing.T) { | |
| cases := []struct { | |
| name string | |
| setup func(t *testing.T, path string) | |
| }{ | |
| {"invalid_json", func(t *testing.T, p string) { | |
| if err := os.WriteFile(p, []byte("{not json"), 0o600); err != nil { | |
| t.Fatal(err) | |
| } | |
| }}, | |
| {"empty_file", func(t *testing.T, p string) { | |
| if err := os.WriteFile(p, nil, 0o600); err != nil { | |
| t.Fatal(err) | |
| } | |
| }}, | |
| {"null_snapshot_and_entries", func(t *testing.T, p string) { | |
| if err := os.WriteFile(p, []byte(`{"version":1,"snapshot":null,"entries":null}`), 0o600); err != nil { | |
| t.Fatal(err) | |
| } | |
| }}, | |
| {"entries_null", func(t *testing.T, p string) { | |
| if err := os.WriteFile(p, []byte(`{"version":1,"snapshot":{"u1":5},"entries":null}`), 0o600); err != nil { | |
| t.Fatal(err) | |
| } | |
| }}, | |
| {"wrong_types", func(t *testing.T, p string) { | |
| if err := os.WriteFile(p, []byte(`{"version":1,"snapshot":"x","entries":42}`), 0o600); err != nil { | |
| t.Fatal(err) | |
| } | |
| }}, | |
| {"top_level_array", func(t *testing.T, p string) { | |
| if err := os.WriteFile(p, []byte("[]"), 0o600); err != nil { | |
| t.Fatal(err) | |
| } | |
| }}, | |
| {"path_is_directory", func(t *testing.T, p string) { | |
| if err := os.Mkdir(p, 0o755); err != nil { | |
| t.Fatal(err) | |
| } | |
| }}, | |
| } | |
| for _, c := range cases { | |
| t.Run(c.name, func(t *testing.T) { | |
| path := filepath.Join(t.TempDir(), "credit-history.json") | |
| c.setup(t, path) | |
| l := New(path, 100) // 必须不 panic | |
| base := len(l.Read(0)) | |
| l.Observe("fresh", 100) // 基线 | |
| l.Observe("fresh", 130) // +30 | |
| got := l.Read(0) | |
| if len(got) != base+1 { | |
| t.Fatalf("退化输入后应能正常观测:base=%d 期望 %d 条,得到 %d(%+v)", base, base+1, len(got), got) | |
| } | |
| if got[0].UID != "fresh" || got[0].Delta != 30 || got[0].Before != 100 || got[0].After != 130 { | |
| t.Fatalf("新增流水字段不符: %+v", got[0]) | |
| } | |
| }) | |
| } | |
| } | |
| // ── 3. maxEntries 回落与截断 ────────────────────────────────────────────── | |
| // maxEntries <= 0 回落默认上限,不产生无界增长;=1 只留最新一条。 | |
| func TestFaultMaxEntriesFallbackAndTrim(t *testing.T) { | |
| for _, m := range []int{0, -1, -1000} { | |
| l := New("", m) | |
| if l.max != defaultMaxEntries { | |
| t.Fatalf("maxEntries=%d 应回落默认 %d,得到 %d", m, defaultMaxEntries, l.max) | |
| } | |
| } | |
| // 不无界增长:写 defaultMaxEntries+300 次,条数必须恰为默认上限。 | |
| l := New("", 0) | |
| l.Observe("u1", 0) | |
| for i := int64(1); i <= int64(defaultMaxEntries)+300; i++ { | |
| l.Observe("u1", i) | |
| } | |
| got := l.Read(0) | |
| if len(got) != defaultMaxEntries { | |
| t.Fatalf("默认上限 %d 应截断,得到 %d", defaultMaxEntries, len(got)) | |
| } | |
| if got[0].After != int64(defaultMaxEntries)+300 { | |
| t.Fatalf("截断后最新一条应保留,得到 %+v", got[0]) | |
| } | |
| // maxEntries=1:只留最新一条,且丢的是最旧。 | |
| l1 := New("", 1) | |
| l1.Observe("u1", 0) | |
| l1.Observe("u1", 10) | |
| l1.Observe("u1", 20) | |
| one := l1.Read(0) | |
| if len(one) != 1 || one[0].After != 20 || one[0].Delta != 10 { | |
| t.Fatalf("上限 1 应只留最新一条,得到 %+v", one) | |
| } | |
| } | |
| // ── 4. Read 边界 ────────────────────────────────────────────────────────── | |
| // limit<=0 = 全部;大于总数 = 全部;1 = 最新;顺序严格新的在前。 | |
| func TestFaultReadBoundaries(t *testing.T) { | |
| l := New("", 100) | |
| l.Observe("u1", 0) | |
| for i := int64(1); i <= 3; i++ { | |
| l.Observe("u1", i*10) | |
| } | |
| cases := []struct { | |
| name string | |
| limit int | |
| want int | |
| }{ | |
| {"zero_is_all", 0, 3}, | |
| {"negative_is_all", -7, 3}, | |
| {"over_total_is_all", 99, 3}, | |
| {"exact_total", 3, 3}, | |
| {"two", 2, 2}, | |
| {"one", 1, 1}, | |
| } | |
| for _, c := range cases { | |
| if got := l.Read(c.limit); len(got) != c.want { | |
| t.Fatalf("%s: Read(%d) 得到 %d 条,期望 %d", c.name, c.limit, len(got), c.want) | |
| } | |
| } | |
| got := l.Read(0) | |
| if got[0].After != 30 || got[1].After != 20 || got[2].After != 10 { | |
| t.Fatalf("必须严格新的在前: %+v", got) | |
| } | |
| got = l.Read(1) | |
| if len(got) != 1 || got[0].After != 30 { | |
| t.Fatalf("Read(1) 应取最新一条: %+v", got) | |
| } | |
| } | |
| // ── 5. Δ 边界 ──────────────────────────────────────────────────────────── | |
| // 恰好 ±maxDelta 记账;±(maxDelta+1) 只更新基线、不留痕,且基线必须推进到新值。 | |
| func TestFaultDeltaBoundaries(t *testing.T) { | |
| // +++ 恰好 +1000000 记账 | |
| l := New("", 100) | |
| l.Observe("u1", 0) | |
| l.Observe("u1", maxDelta) | |
| if got := l.Read(0); len(got) != 1 || got[0].Delta != maxDelta || got[0].Before != 0 || got[0].After != maxDelta { | |
| t.Fatalf("恰好 +%d 应记账: %+v", maxDelta, got) | |
| } | |
| // --- 恰好 -1000000 记账 | |
| l = New("", 100) | |
| l.Observe("u1", maxDelta) | |
| l.Observe("u1", 0) | |
| if got := l.Read(0); len(got) != 1 || got[0].Delta != -maxDelta { | |
| t.Fatalf("恰好 -%d 应记账: %+v", maxDelta, got) | |
| } | |
| // +++ 超限 +1000001 不留痕,但基线推进 | |
| l = New("", 100) | |
| l.Observe("u1", 0) | |
| l.Observe("u1", maxDelta+1) | |
| if got := len(l.Read(0)); got != 0 { | |
| t.Fatalf("超限 +%d 不应留痕,得到 %d 条", maxDelta+1, got) | |
| } | |
| if l.snapshot["u1"] != maxDelta+1 { | |
| t.Fatalf("超限后基线应推进到 %d,得到 %d", maxDelta+1, l.snapshot["u1"]) | |
| } | |
| l.Observe("u1", 1) // Δ = 1-(maxDelta+1) = -maxDelta → 正常记账 | |
| got := l.Read(0) | |
| if len(got) != 1 || got[0].Delta != -maxDelta || got[0].Before != maxDelta+1 || got[0].After != 1 { | |
| t.Fatalf("超限后应按新基线记账: %+v", got) | |
| } | |
| // --- 超限 -1000001 不留痕,基线推进 | |
| l = New("", 100) | |
| l.Observe("u1", 0) | |
| l.Observe("u1", -(maxDelta + 1)) | |
| if got := len(l.Read(0)); got != 0 { | |
| t.Fatalf("超限 -%d 不应留痕,得到 %d 条", maxDelta+1, got) | |
| } | |
| if l.snapshot["u1"] != -(maxDelta + 1) { | |
| t.Fatalf("超限后基线应推进到 %d,得到 %d", -(maxDelta + 1), l.snapshot["u1"]) | |
| } | |
| l.Observe("u1", -1) // Δ = -1-(-(maxDelta+1)) = +maxDelta | |
| got = l.Read(0) | |
| if len(got) != 1 || got[0].Delta != maxDelta || got[0].Before != -(maxDelta+1) { | |
| t.Fatalf("超限后应按新基线记账: %+v", got) | |
| } | |
| } | |
| // ── 6. uid 边界 ─────────────────────────────────────────────────────────── | |
| // 空 uid(上游异常条目)不建基线、不记账。 | |
| func TestFaultEmptyUIDIgnored(t *testing.T) { | |
| l := New("", 100) | |
| l.Observe("", 100) | |
| l.Observe("", 200) | |
| if got := len(l.Read(0)); got != 0 { | |
| t.Fatalf("空 uid 不应记账,得到 %d 条", got) | |
| } | |
| if len(l.snapshot) != 0 { | |
| t.Fatalf("空 uid 不应建基线,得到 %v", l.snapshot) | |
| } | |
| } | |
| // 任务描述要求纯空白 uid(上游脏数据)同样不建基线。当前实现只判 uid == "", | |
| // 纯空白会进快照——此用例作为复现保留,等 lead 裁决。 | |
| func TestFaultWhitespaceUIDNotBaselined(t *testing.T) { | |
| l := New("", 100) | |
| l.Observe(" ", 100) | |
| l.Observe("\t\n", 100) | |
| if got := len(l.Read(0)); got != 0 { | |
| t.Fatalf("纯空白 uid 不应记账,得到 %d 条", got) | |
| } | |
| if len(l.snapshot) != 0 { | |
| t.Fatalf("纯空白 uid 不应建基线,但快照里有 %d 个键: %v", len(l.snapshot), l.snapshot) | |
| } | |
| } | |
| // ── 7. 并发 ────────────────────────────────────────────────────────────── | |
| // 多 goroutine(不同 uid 定量 + 同一 uid 混跑)不 panic、不同 uid 条数不丢、 | |
| // 磁盘与内存逐条一致;同一 uid 并发后再顺序写一个唯一哨兵,必须是最终基线。 | |
| func TestFaultConcurrentMixedUIDs(t *testing.T) { | |
| path := filepath.Join(t.TempDir(), "credit-history.json") | |
| l := New(path, 4000) | |
| const accounts = 6 | |
| const rounds = 30 | |
| for i := 0; i < accounts; i++ { | |
| l.Observe(fmt.Sprintf("acct-%d", i), 0) | |
| } | |
| l.Observe("shared", 0) | |
| var wg sync.WaitGroup | |
| for i := 0; i < accounts; i++ { | |
| uid := fmt.Sprintf("acct-%d", i) | |
| wg.Add(1) | |
| go func() { | |
| defer wg.Done() | |
| for n := int64(1); n <= rounds; n++ { | |
| l.Observe(uid, n*10) | |
| } | |
| }() | |
| } | |
| for w := 0; w < 8; w++ { | |
| base := int64(w) * 1000 | |
| wg.Add(1) | |
| go func() { | |
| defer wg.Done() | |
| for n := int64(1); n <= 20; n++ { | |
| l.Observe("shared", base+n) | |
| } | |
| }() | |
| } | |
| wg.Wait() | |
| // 顺序写入唯一哨兵 = 「最后一次写入」,并发结束后必须生效。 | |
| l.Observe("shared", 777777) | |
| if l.snapshot["shared"] != 777777 { | |
| t.Fatalf("最后写入应成为基线,得到 %d", l.snapshot["shared"]) | |
| } | |
| mem := l.Read(0) | |
| per := map[string]int{} | |
| for _, e := range mem { | |
| per[e.UID]++ | |
| } | |
| for i := 0; i < accounts; i++ { | |
| uid := fmt.Sprintf("acct-%d", i) | |
| if per[uid] != rounds { | |
| t.Fatalf("%s 应有 %d 条流水,得到 %d", uid, rounds, per[uid]) | |
| } | |
| } | |
| // 磁盘必须与内存逐条一致(慢写覆盖会让磁盘少条/快照回退)。 | |
| l2 := New(path, 4000) | |
| disk := l2.Read(0) | |
| if len(disk) != len(mem) { | |
| t.Fatalf("重启后条数不一致:内存 %d / 磁盘 %d", len(mem), len(disk)) | |
| } | |
| for i := range mem { | |
| m, d := mem[i], disk[i] | |
| // 不能直接比较 struct:内存里的 time.Time 带单调时钟读数,落盘再读回后没有。 | |
| if m.UID != d.UID || m.Delta != d.Delta || m.Before != d.Before || m.After != d.After || !m.Time.Equal(d.Time) { | |
| t.Fatalf("第 %d 条内存/磁盘不一致: 内存 %+v / 磁盘 %+v", i, m, d) | |
| } | |
| } | |
| if l2.snapshot["shared"] != 777777 { | |
| t.Fatalf("重启后 shared 基线应为 777777,得到 %d", l2.snapshot["shared"]) | |
| } | |
| for i := 0; i < accounts; i++ { | |
| uid := fmt.Sprintf("acct-%d", i) | |
| if l2.snapshot[uid] != rounds*10 { | |
| t.Fatalf("重启后 %s 基线应为 %d,得到 %d", uid, rounds*10, l2.snapshot[uid]) | |
| } | |
| } | |
| } | |
| // ── 8. 临时文件残留与文件权限 ────────────────────────────────────────────── | |
| // 正常落盘(临时文件 + rename)不得在目录里留下 .tmp 残留。 | |
| func TestFaultNoTempResidueAfterWrite(t *testing.T) { | |
| dir := t.TempDir() | |
| path := filepath.Join(dir, "credit-history.json") | |
| l := New(path, 100) | |
| l.Observe("u1", 1) | |
| l.Observe("u1", 2) | |
| l.Observe("u1", 3) | |
| left, err := filepath.Glob(filepath.Join(dir, "*.tmp")) | |
| if err != nil { | |
| t.Fatal(err) | |
| } | |
| if len(left) != 0 { | |
| t.Fatalf("正常落盘不应残留临时文件,发现 %v", left) | |
| } | |
| if _, err := os.Stat(path); err != nil { | |
| t.Fatalf("应有账本文件: %v", err) | |
| } | |
| } | |
| // 账本文件权限不得宽于 0600。Windows 的 os.WriteFile 不套用 POSIX 权限位, | |
| // Stat().Mode().Perm() 恒为 0666,故该断言只在 POSIX 生效。 | |
| func TestFaultFileModeNotWiderThan0600(t *testing.T) { | |
| if runtime.GOOS == "windows" { | |
| t.Skip("Windows 不应用 POSIX 权限位(Perm() 恒为 0666);该断言只在 POSIX 生效") | |
| } | |
| path := filepath.Join(t.TempDir(), "credit-history.json") | |
| l := New(path, 100) | |
| l.Observe("u1", 1) | |
| fi, err := os.Stat(path) | |
| if err != nil { | |
| t.Fatal(err) | |
| } | |
| if perm := fi.Mode().Perm(); perm&0o077 != 0 { | |
| t.Fatalf("账本文件权限不应宽于 0600,得到 %04o", perm) | |
| } | |
| } | |