不能直接用c.Set()传用户ID或租户ID，因为其作用域仅限当前echo.Context实例，无法透传至下游中间件、数据库层（如sqlx.QueryRowContext）或日志器（如zap.Logger.With），必须通过context.WithValue()更新请求上下文并调用c.SetRequest()显式替换，否则元数据丢失。
为什么不能直接用 c.Set() 传用户ID或租户ID
因为 c.Set() 只在当前 echo.Context 实例内有效，不会自动进入下游中间件或第三方库（比如 sqlx.QueryRowContext()、zap.Logger.With()）。常见错误现象是：中间件 A 调用了 c.Set("user_id", 123)，中间件 B 或 handler 里调 c.Get("user_id") 能取到；但一进数据库层，db.QueryContext(c.Request().Context(), ...) 拿不到——因为 c.Request().Context() 还是原始的，没被更新。
必须用 context.WithValue() + c.SetRequest()
Go 标准库的 context.Context 才是跨组件传递元数据的唯一可靠载体。Echo v4+ 要求你显式替换请求的 Context，否则新值永远不生效。关键三步：
- 定义类型安全的键：
type ctxKey string，然后const userIDKey ctxKey = "user_id" - 在中间件中构建新 Context：
newCtx := context.WithValue(c.Request().Context(), userIDKey, uid) - **必须**调用
c.SetRequest(c.Request().WithContext(newCtx))，否则后续所有c.Request().Context()都还是旧的
漏掉第三步是生产环境最常踩的坑——值塞进去了，但没人看得到。
下游 handler 和 DB 怎么安全取值
所有消费端都必须统一从 c.Request().Context().Value() 取，且使用完全相同的键类型和变量名。不要混用 c.Get() 和 context.Value()，它们互不感知。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- handler 里：
uid := c.Request().Context().Value(userIDKey).(int64)（注意类型断言） - DB 查询：
rows, _ := db.QueryContext(c.Request().Context(), "SELECT * FROM users WHERE id = $1", uid) - 日志打点（如 zap）：
logger.With(zap.Any("user_id", uid)).Info("user login")，但若日志器本身支持 context 提取（如zap.WithContext(c.Request().Context())），优先走那条链路
键必须是自定义类型（不能是 string），否则不同包之间字符串键容易冲突，且 Go 类型系统无法帮你检查。
request_id 等观测性字段怎么透传到 logger 和 DB
和用户ID逻辑一致，但更强调“一次生成、全程携带”。典型做法是在入口中间件（如 middleware.RequestID()）生成 ID 后立即注入 Context，并确保所有异步操作（goroutine、定时任务）都显式传入该 Context。
- 生成并注入：
rid := uuid.NewString(); newCtx := context.WithValue(c.Request().Context(), requestIDKey, rid) - 更新请求：
c.SetRequest(c.Request().WithContext(newCtx)) - DB 层必须用
QueryContext(c.Request().Context(), ...)，不能用Query(...) - logrus/zap 等日志库需配置为从 Context 提取字段，或手动
logger.With(...).Info()补充
真正复杂的是跨 goroutine 场景：比如 handler 启了个子 goroutine 做异步审计，必须把 c.Request().Context() 显式传进去，否则它拿到的是 background context，元数据全丢。
