- 纯函数单测(go test -short)覆盖: classification (levelIndex/maxLevel/materializeClassification/principalMaxIndex/deniedLevelsFor)、 display_name (propString/resolveDisplayName)、 governance (diffProps/mergeProps/parseStringArray/similarity) - 集成测试(-tags=integration,跑真实 PG)覆盖 issue #4 #5 端到端: enum_violation 拦截 + 友好错误;分级过滤 manager vs analyst(L0/L1) 越级 404; properties.sensitivity 越级 redact 为 ***;删→恢复关系边 (links_snapshot+edges_created=1); recompute dry_run 不落库 / apply=true 落库修正错误分级 - 集成测试踩坑:X-Principal 与 principal_clearances.principal 必须一致;每次新主体必须清 authzCache(sync.Map 进程级),否则历史空 Authz 会让分级过滤假阴性 - docs/TESTING.md:测试分层 / 跑测命令 / 编写新测试的约定 - CHANGELOG [1.2.0] 加 测试 与 文档 段落
2.7 KiB
2.7 KiB
测试规范
本仓库的测试分两层:纯函数单测(无外部依赖,几百毫秒)和集成测试(走真实 HTTP + Postgres,端到端验证业务行为)。
跑测试
1. 纯函数单测(默认)
go test -short ./server/
包含 classification_test.go / display_name_test.go / instance_governance_test.go 中所有不依赖 DB 的函数验证。
11 个用例,约 0.7s。
2. 集成测试(端到端,需真实 PG)
go test -tags=integration -timeout 90s ./server/
包含 integration_test.go 中 5 个核心业务回归用例:
| 用例 | 验证 | 关联 |
|---|---|---|
TestIntegration_EnumValidation |
枚举越界返回 400 / enum_violation,空值放行,合法值落库 |
issue #5-① |
TestIntegration_ClassificationFilter |
manager 见全部,analyst(L0,L1) 只见 L0/L1,越级直取 404 | issue #5-③④ |
TestIntegration_FieldSensitivity |
properties.sensitivity 越级 redact 为 ***,公开字段保留 |
issue #5-② |
TestIntegration_RestoreEdges |
删除级联清边 + 存快照 → 恢复时 edges_created=1 + 边真重建 |
issue #4 |
TestIntegration_RecomputeApply |
dry_run 不落库、apply=true 修正错误分级 | issue #5-⑩ |
前置条件
- 本地 PG 可达,默认
localhost:15432/shangshu(dev dockerjnpf-postgres)。 - 覆盖默认连接:设置环境变量
TEST_DATABASE_URL:export TEST_DATABASE_URL="postgres://dacli:dacli123@localhost:15432/shangshu?sslmode=disable" - 每个测试用
TestRgo_<TestName>_<nanos>唯一化对象类型名 + t.Cleanup 物理清理;analyst共享主体不清(仅扩大可见集不影响正确性)。
3. 全部(CI 用)
go test -tags=integration -timeout 120s ./server/...
编写新测试的约定
单测:放 *_test.go 同包,无需 build tag
- 必须纯函数:不引
*app.pool/*pgxpool.Pool/os.Getenv。 - 用标准库
testing+ 表驱动 + 明确 want/期望。
集成测试:放 integration_test.go(或新文件加 //go:build integration)
- 走真实 HTTP:
httptest.NewServer(registerRoutes(r, a))。 - 调用
setupTestEnv(t)拿*testEnv,自动清理测试类型。 - 必须清缓存:
invalidateClassCache()+authzCache.Range(...Delete...), 否则前一次测试的authzCache[analyst]=空 Authz会让后续测试以为"无 clearance"。 - 验证状态用
body["xxx"]断言时记得 nil-check,宁可if got, ok := body["x"].(string); !ok不要硬断言。
提交前
- 跑完
go test -tags=integration ./server/全绿再 commit。 - 涉及缓存/连接/事务的改动要新增/更新集成测试,确保下次重构能立刻发现回归。