Echo中审计日志必须用context.WithValue注入trace_id并构造context-aware日志实例，而非仅c.Set()；需在首个中间件生成/透传trace_id，确保goroutine、HTTP客户端及异步操作均继承该上下文，实现全链路可追溯与不可篡改。
直接记录用户操作审计日志不能只靠 c.Set() 存个字段就完事——审计日志要求可追溯、不可篡改、带上下文完整性，而 Echo 的 echo.Context 是请求生命周期内临时对象，不跨 goroutine、不透传到日志库、不绑定 HTTP 客户端调用，稍有疏忽就会漏掉关键链路。
auditMiddleware 里必须提取并验证真实用户身份
审计日志的核心是“谁在什么时间做了什么”，第一环就是确认 user_id 或 subject 是否可信。不能依赖前端传来的任意字段，也不能在 Handler 里才查 DB 补充——必须在审计中间件中完成校验和提取：
- 优先从已认证中间件（如 JWT）挂载的
c.Get("user")取结构体，而不是反复解析Authorization头 - 若未通过认证中间件，应直接拒绝，不进入审计逻辑；避免“先记日志再报错”导致日志污染
- 对匿名操作（如 /healthz、/metrics），显式标记
"user_id": "anonymous"和"is_anonymous": true，而非留空或 omit 字段 - 敏感操作（如 DELETE /users/:id）建议额外校验
c.Request().Method == "DELETE" && strings.Contains(c.Request().URL.Path, "/users/")，触发更严格字段捕获（如原 IP、User-Agent、请求体摘要）
审计日志字段必须包含 trace_id + request_id + operation_type
没有 trace_id 的审计日志等于无索引的纸条。Echo 默认不注入，且仅靠 c.Set("trace_id", ...) 无法被 zap/zerolog 感知：
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 生成时机：在第一个中间件（早于 auth）中检查
c.Request().Header.Get("X-Trace-ID")和traceparent，缺失时用uuid.NewString()创建 - 注入方式：必须调用
c.SetRequest(c.Request().WithContext(context.WithValue(c.Request().Context(), ctxKey, traceID)))，否则下游http.Client.Do(req)会丢失 - 日志字段：审计日志至少含
"trace_id"、"request_id"（可复用 trace_id）、"operation_type"（如"user_delete"）、"resource"（如"users/123"）、"status"（成功/失败）、"ip"、"user_agent" - 失败操作也要记：即使
next(c)返回 error，也要在 defer 或 recover 后补全"status": "failed"和"error_message"（脱敏后）
别把审计日志写进 c.Logger，要用 context-aware 日志实例
很多人写 c.Logger().Info(...)，结果发现所有审计日志都挤在一条线程上、没 trace_id、字段缺失——因为 c.Logger() 是 Echo 实例级别的单例，根本不读取当前请求的 context.Context：
- 正确做法：在审计中间件开头，用
zerolog.Ctx(c.Request().Context())或zap.L().With(zap.String("trace_id", traceID))构造新 logger 实例 - 若用 rk-boot，直接调
rkechoctx.GetLogger(c)，它已自动注入 trace_id 和 request_id - 异步操作（如发 Kafka、写 DB）必须显式传入该 logger 对应的
context.Context，否则 goroutine 中的日志彻底脱离链路 - 避免在
defer中调用c.Logger()—— defer 执行时c可能已被回收，panic 风险高
真正难的不是写一行 log.Info().Str("op", "delete_user").Send()，而是确保这行日志能和下游服务的 DB 删除语句、消息队列事件、前端埋点在同一个 trace 下对齐。Audit 不是打点，是建立因果证据链——每个中间件都是证人，但只有第一个拿到 context.Context 并坚持传递的人，才算出庭作证。
