Files
knowledge-governance/internal/libraryadmission/admission_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

94 lines
3.2 KiB
Go

package libraryadmission
import (
"errors"
"strings"
"testing"
)
func base() (Target, Facts) {
configured := Target{DatabaseEndpoint: "pg:5432/db", Index: "idx", Bucket: "b",
KnowledgeBaseID: "kb-int", TenantID: 10001, SchemaVersion: 71, Instance: "kgseal"}
facts := Facts{Live: Target{DatabaseEndpoint: "pg:5432/db", Index: "idx", Bucket: "b",
KnowledgeBaseID: "kb-int", TenantID: 10001, SchemaVersion: 71, Instance: "kgseal"}}
return configured, facts
}
func TestVerifyAllowsCleanUniqueTarget(t *testing.T) {
configured, facts := base()
if err := Verify(configured, facts); err != nil {
t.Fatalf("干净且唯一的目标应放行:%v", err)
}
}
// 未知一律拒绝:读不到实况/旧路由/维护窗口。
func TestVerifyFailsClosedOnUnknown(t *testing.T) {
configured, facts := base()
cases := map[string]Facts{
"读不到目标实况": {LiveErr: errors.New("connect refused")},
"读不到旧release": {LegacyErr: errors.New("query failed")},
"读不到维护窗口": {HeldErr: errors.New("query failed")},
}
for name, broken := range cases {
if err := Verify(configured, broken); err == nil {
t.Fatalf("%s 时必须拒绝", name)
}
}
if err := Verify(configured, Facts{Live: Target{KnowledgeBaseID: "kb-int", TenantID: 10001}}); err == nil ||
!strings.Contains(err.Error(), "schema") {
t.Fatalf("schema 读不到时必须拒绝:%v", err)
}
_ = facts
}
// 目标实况与配置不一致 ⇒ 拒绝(不能只信配置)。
func TestVerifyRejectsMismatchedLiveTarget(t *testing.T) {
configured, facts := base()
facts.Live.KnowledgeBaseID = "another-kb"
if err := Verify(configured, facts); err == nil {
t.Fatal("目标实况与配置不一致必须拒绝")
}
configured, facts = base()
facts.LiveDirty = true
if err := Verify(configured, facts); err == nil {
t.Fatal("dirty schema 必须拒绝")
}
configured, facts = base()
facts.Live.SchemaVersion = 72
if err := Verify(configured, facts); err == nil {
t.Fatal("schema 版本不一致必须拒绝")
}
}
// 旧 release 路由指向同一个知识库 ⇒ 两个执行域重叠,拒绝。
func TestVerifyRejectsLegacyReleaseOverlap(t *testing.T) {
configured, facts := base()
facts.LegacyReleaseKB = "kb-int"
err := Verify(configured, facts)
if err == nil {
t.Fatal("旧 release 路由与整库目标同一个 KB 时必须拒绝(R4)")
}
if !strings.Contains(err.Error(), "旧 release") {
t.Fatalf("拒绝原因必须指向旧 release 路由:%v", err)
}
// 指向别的知识库则不重叠。
facts.LegacyReleaseKB = "kb-other"
if err := Verify(configured, facts); err != nil {
t.Fatalf("不同知识库不算重叠:%v", err)
}
}
// 别的实例持有未释放窗口 ⇒ 拒绝;自己持有则允许(重启后的自我接管)。
func TestVerifyRejectsForeignHeldWindow(t *testing.T) {
configured, facts := base()
facts.HeldInstance, facts.HeldJob = "other-instance", "libsync-x"
if err := Verify(configured, facts); err == nil {
t.Fatal("别的实例持有未释放窗口时必须拒绝")
}
configured, facts = base()
facts.HeldInstance, facts.HeldJob = "kgseal", "libsync-x"
if err := Verify(configured, facts); err != nil {
t.Fatalf("自己持有窗口时允许注册(重启接管):%v", err)
}
}