Files
knowledge-governance/internal/librarydeadletter/deadletter_test.go
T
姚章浩 c2402947a9
build / build (push) Successful in 1m26s
feat(library): 死信按精确指纹解除,保留上游记录
上游 task_dead_letters 没有解决标记,purge/DELETE 会销毁"失败过"的唯一证据。
治理侧新增解除记录(迁移 073):绑定实时行逐字节指纹、重放引用、源侧观测摘要与
操作人;行被改过、重放后又出现新死信、源侧未结清都不命中,封存照旧阻断。
指纹先压紧空白再摘要,避免 PG to_jsonb::text 与 json.Marshal 的空白差异。

试过:go test ./internal/{librarydeadletter,libraryagent,httpapi,releaseadapter/v071,
platform/postgres},make verify 15 项全绿。
2026-10-29 06:55:13 +08:00

114 lines
4.3 KiB
Go

package librarydeadletter
import (
"encoding/json"
"strings"
"testing"
"time"
)
const sampleRow = `{"id": 7, "payload": {"id": "k1"}, "scope": "knowledge", "scope_id": "k1", "failed_at": "2026-10-28T10:00:00+00:00", "last_error": "boom", "task_type": "wiki:ingest", "tenant_id": 10001, "fail_count": 3, "related_id": "k1"}`
func observation(t *testing.T, rows ...string) (json.RawMessage, string) {
t.Helper()
value := Observation{
Project: "kgmaint-weknora", TenantID: 10001, KnowledgeBaseID: "kb-1",
CapturedAt: time.Date(2026, 10, 29, 7, 0, 0, 0, time.UTC),
Settlement: Settlement{Unsettled: 0, PendingOps: 0},
}
for _, row := range rows {
value.Rows = append(value.Rows, json.RawMessage(row))
}
raw, err := json.Marshal(value)
if err != nil {
t.Fatalf("marshal observation: %v", err)
}
return raw, Fingerprint(raw)
}
func request(t *testing.T, raw json.RawMessage, digest string) Request {
t.Helper()
return Request{
Project: "kgmaint-weknora", DeadLetterID: 7,
Replay: Replay{Queue: "default", TaskID: "task-1", At: time.Date(2026, 10, 29, 6, 30, 0, 0, time.UTC),
Evidence: "run_now 200"},
Observation: raw, Digest: digest,
}
}
func TestVerifyAcceptsExactReleasedDeadLetter(t *testing.T) {
raw, digest := observation(t, sampleRow)
release, err := Verify(request(t, raw, digest), "kgmaint-weknora", time.Date(2026, 10, 29, 7, 5, 0, 0, time.UTC))
if err != nil {
t.Fatalf("exact release rejected: %v", err)
}
if release.DeadLetterID != 7 || release.Fingerprint != Fingerprint([]byte(sampleRow)) ||
release.TaskType != "wiki:ingest" || release.TenantID != 10001 {
t.Fatalf("release lost its binding: %+v", release)
}
}
func TestVerifyRejectsUnsafeReleases(t *testing.T) {
cases := []struct {
name string
mutate func(*Request, *Observation)
want string
}{
{"观察摘要被改写", func(r *Request, _ *Observation) { r.Digest = Fingerprint([]byte("other")) }, "观测摘要"},
{"未结清", func(_ *Request, o *Observation) { o.Settlement.PendingOps = 1 }, "尚未结清"},
{"断言的死信不存在", func(r *Request, _ *Observation) { r.DeadLetterID = 8 }, "没有这条死信"},
{"重放早于失败", func(r *Request, _ *Observation) {
r.Replay.At = time.Date(2026, 10, 28, 9, 0, 0, 0, time.UTC)
}, "早于"},
{"重放没有队列", func(r *Request, _ *Observation) { r.Replay.Queue = "" }, "队列"},
{"重放后同一任务又失败", func(_ *Request, o *Observation) {
o.Rows = append(o.Rows, json.RawMessage(
`{"id": 9, "payload": {"id": "k1"}, "scope": "knowledge", "scope_id": "k1", "failed_at": "2026-10-29T06:45:00+00:00", "last_error": "boom", "task_type": "wiki:ingest", "tenant_id": 10001, "fail_count": 3, "related_id": "k1"}`))
}, "新死信"},
{"实例不一致", func(r *Request, _ *Observation) { r.Project = "other" }, "不一致"},
}
for _, test := range cases {
t.Run(test.name, func(t *testing.T) {
raw, digest := observation(t, sampleRow)
var body Observation
if err := json.Unmarshal(raw, &body); err != nil {
t.Fatal(err)
}
req := request(t, raw, digest)
test.mutate(&req, &body)
if test.name == "重放后同一任务又失败" || test.name == "未结清" {
reserialized, err := json.Marshal(body)
if err != nil {
t.Fatal(err)
}
req.Observation, req.Digest = reserialized, Fingerprint(reserialized)
}
if _, err := Verify(req, "kgmaint-weknora", time.Date(2026, 10, 29, 7, 5, 0, 0, time.UTC)); err == nil ||
!strings.Contains(err.Error(), test.want) {
t.Fatalf("unsafe release accepted: %v", err)
}
})
}
}
func TestVerifyRejectsUnconfiguredInstance(t *testing.T) {
raw, digest := observation(t, sampleRow)
if _, err := Verify(request(t, raw, digest), "", time.Now()); err == nil {
t.Fatal("release accepted without a configured instance")
}
}
func TestUnreleasedNamesEveryRow(t *testing.T) {
rows := [][]byte{[]byte(sampleRow), []byte(strings.Replace(sampleRow, `"id": 7`, `"id": 8`, 1))}
missing, err := Unreleased(rows, map[string]bool{Fingerprint(rows[0]): true})
if err != nil {
t.Fatal(err)
}
if len(missing) != 1 || !strings.HasPrefix(missing[0], "8:sha256:") {
t.Fatalf("unexpected coverage: %v", missing)
}
if _, err := Unreleased([][]byte{[]byte("not json")}, nil); err == nil {
t.Fatal("unparseable row was treated as released")
}
}