service/TEST.md

Service Module Test Report

v1.5.22 验证

• go list -m all：模块图使用 discover v1.5.8、redis v1.5.11 与稳定版 redigo v1.9.3。
• go test -v ./... 与 go test -bench=. ./... 全部通过。

v1.5.21 验证

• go list -m all：模块图使用 discover v1.5.7、redis v1.5.11 与稳定版 redigo v1.9.3。
• go test -v ./... 与 go test -bench=. ./... 全部通过。

性能测试 (Benchmark)

• 测试日期: 2026-07-19
• 版本: v1.5.22
• 指标: BenchmarkRouting: 2269 ns/op
• 环境: Darwin / Apple M3 Max

单元测试覆盖 (Unit Test)

• TestServeHTTP: 基础请求与响应
• TestServeHTTP_404: 404 处理
• TestServeHTTP_VerifyFailed: 参数校验失败处理
• TestServeHTTP_Panic: (New) 验证全局 Panic 恢复与日志记录
• TestRewrite: 路径重写
• TestProxyDirect: 代理转发 (Mock)
• TestAsyncServer: 异步启动与生命周期 (已验证 Server Timeout 配置生效)
• TestServiceRegister: 基础路由注册
• TestRegexServiceRegister: 正则路由注册
• TestStaticService: 静态文件服务 (已支持内存文件与自动日志记录)
• TestVerifyStruct: 基础结构校验
• TestNestedVerify: 嵌套结构校验
• TestCustomVerify: 自定义校验函数
• TestWebSocketService: WebSocket 注册
• TestGetDefaultName: 自动应用名识别
• TestGetServerIp: 自动 IP 探测
• TestSmartStartup: 零配置智能启动与 Discover 注册
• TestSanitizeScalars ~ TestSanitizeMixedSlice: 日志脱敏 10 个测试（标量/对象/数组/嵌套/预算/Unicode）
• TestSessionLogic: Session Save/Load/Remove 及 AuthFuncs
• TestSessionInjection: Session HTTP 注入流程
• Logging Filters: NoLogInput/NoLogOutput/NoLogAllHeaders/NoLogGets/NoLogRequestHeaders/NoLogResponseHeaders/NoLogResponseFields
• Client Keys: Device-Id/Session-Id 应答头条件化（请求有则不应答）、静态文件/WebSocket 仅 Cookie
• Cookie 头智能过滤: 排除列表中 key 从 Cookie 内容中剔除，保留业务 Cookie
• Response Body: 200 响应和 dev 模式下 keepBody 捕获

基础设施对齐验证

• 成功集成 apigo.cc/go/cast 用于参数解析与类型强转。
• 成功集成 apigo.cc/go/timer 用于高性能耗时追踪。
• 成功集成 apigo.cc/go/log 并实现完整的 Request 日志记录，支持头过滤与内容截断。
• 强制集成 apigo.cc/go/file 替代原生 os，全面支持内存虚拟文件系统。
• 成功集成 apigo.cc/go/id 与 go/redis 实现分布式有序 ID。
• 成功集成 apigo.cc/go/discover 并支持 H2C 协议的零配置自动注册。
• Safety: 已集成 recover 机制，保障服务在高并发业务 Panic 时的稳定性。