Files
admin ae9a1a69e2 test: 加 16 个回归测试 (11 纯函数 + 5 集成) + docs/TESTING.md
- 纯函数单测(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] 加 测试 与 文档 段落
2026-09-07 10:11:39 +08:00

2.7 KiB
Raw Permalink Blame History

测试规范

本仓库的测试分两层:纯函数单测(无外部依赖,几百毫秒)和集成测试(走真实 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 docker jnpf-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。
  • 涉及缓存/连接/事务的改动要新增/更新集成测试,确保下次重构能立刻发现回归。