Files
knowledge-governance/cmd/worker/library_identity_helpers_test.go
T
姚章浩 a7d643635a
build / build (push) Successful in 1m27s
fix(library): 守卫按行取作业身份、同作业多代次、原作业续作与执行域准入
R1 维护/发布守卫硬编码 j.id=$1:维护类入口的 $1 是 scope/instance,作业号在 $2,
导致 update/release/ingress 六个入口正常路径全部匹配不到作业。改为按被更新行自己的
owner_job_id 生成条件,并同时要求该代次在 library_attempts 里仍活跃。

R2 认领只改 jobs.attempt_epoch 不改 attempts.epoch,第二次接管即错位;唯一索引
(job_id) 与"每次接管新 attempt 且历史不可变"矛盾。改为同作业多代次:锁作业行与
operation 行、同 owner 幂等续租、活跃未过期者让路、过期/本作业旧代次标 abandoned、
新代次 epoch=max+1,并清同 operation 其它作业行租约。迟到 write/renew/finish 一律
ErrLibraryEpochStale(finish 补了"只能在活跃态进来一次")。

R3 续作不再新建 -resume 作业:PrepareLibraryJobResume 让原业务作业回 pending 并显式
结束上一代,维护窗口/journal/预备份/写集合仍按原作业 id 归属,代次由 worker 起手递增。

R4 执行域准入改为注册 handler 前读事实:目标实况(KB/租户/schema/索引)、旧 release
路由绑定的 KB、未释放维护窗口持有者;未知或重叠即拒绝执行(不做维护动作、不停既有服务)。

同时自纠 5 项设计偏离:current 次序键取意图创建时间(旧意图迟到事实被拒)、首次锚点
改事务 FOR UPDATE + 回读且 NULL≠0、版本事件冲突只做加法且 xmax=0 才算新事实、
恢复作为新 kind=recover 意图推进 current、隔离测试加测试库护栏并清理残留 schema。

测试:真实 PG(kg-pgtest-writeset,一用例一 schema)新增 8 条集成用例覆盖上述正负例;
go test ./... 全绿(50 包)、go vet/build rc=0、web tsc + vitest 485 通过、make verify 16 项通过。
2026-10-30 17:20:40 +08:00

46 lines
1.8 KiB
Go

package main
import (
"context"
"testing"
"time"
"knowledge-governance/internal/governance"
postgresstore "knowledge-governance/internal/platform/postgres"
)
// 版本事件的执行身份(父的复核项 R2/F02):一条版本事件属于**一次意图**(operation),
// 不是快照的终身属性。测试要造"同一个快照被另一个作业重新登记",就必须真的换一个意图,
// 而不是靠旧实现的 upsert 改写 source_job_id —— 那条路径现在已经按设计禁止了。
func testLibraryOperation(t *testing.T, store *postgresstore.Store, scope string,
kind governance.LibraryJobKind, key string, at time.Time) string {
t.Helper()
ctx := context.Background()
op, _, err := store.EnsureLibraryOperation(ctx, governance.LibraryOperation{
ID: governance.LibraryOperationID(scope, kind, key), Scope: scope, Kind: kind,
TargetSnapshotID: "target-" + key, RequestDigest: "digest-" + key, OperationKey: key,
Actor: "tester", CreatedAt: at.UTC(),
})
if err != nil {
t.Fatalf("ensure test operation %s: %v", key, err)
}
return op.ID
}
// recordVersionEvent 以给定意图登记一条版本事件(id 与 operation 身份一致)。
func recordVersionEvent(t *testing.T, store *postgresstore.Store, scope string,
kind governance.LibraryVersionKind, snapshot, jobID, operationID string, at time.Time,
evidence map[string]any) {
t.Helper()
if err := store.RecordLibraryVersion(context.Background(), governance.LibraryVersion{
ID: governance.LibraryVersionEventID(kind, scope, snapshot, operationID),
Scope: scope,
Kind: kind,
SnapshotID: snapshot,
SourceJobID: jobID, OperationID: operationID, CreatedBy: "worker",
Evidence: evidence, CreatedAt: at.UTC(),
}); err != nil {
t.Fatalf("record %s version for %s (job %s): %v", kind, snapshot, jobID, err)
}
}