context.WithValue链深超10层性能显著下降，因底层为单向链表导致O(n)查找；string类型key易冲突，须用未导出类型+全局变量；多值应打包为结构体单次注入；HTTP中间件需用r.WithContext()传递，否则值无法到达handler。
context.WithValue 链深超 10 层会明显变慢
不是“可能慢”，是实测确定：链深达 10 层后，ctx.Value(key) 查找耗时翻倍；到 20 层时，在每秒万级请求的鉴权中间件里，context.(*valueCtx).Value 会出现在 pprof CPU 热点栈顶。底层是单向链表，每次查找都要从当前节点逐层向上遍历，时间复杂度 O(n)。
常见触发场景：
- 5 层 HTTP 中间件（日志、鉴权、租户路由、语言解析、trace 注入）
- 叠加 3 层 DB wrapper（事务、重试、指标埋点）
- 再套 2 层重试逻辑（
context.WithTimeout+WithValue套娃）
调试方法：写个临时 depth(ctx) 递归计数函数，在 handler 入口打印；上线环境禁用，仅用于定位。
为什么 string 类型的 key 一定会出问题
写 context.WithValue(ctx, "user_id", 123) 看似简单，但不同包里都用这个字符串，值会互相覆盖——Go 的 == 对字符串字面量成立，且无命名空间隔离。编译器不报错，运行时取到的可能是别人塞的值。
立即学习“go语言免费学习笔记（深入）”；
正确做法必须用未导出类型：
- 定义
type userIDKey struct{}（推荐空 struct，零内存） - 全局唯一变量：
var UserIDKey = userIDKey{} - 绝不在多个文件里各自定义
type Key string——类型不等价，ctx.Value(k1)永远拿不到ctx.Value(k2)
取值时也必须用同一变量：ctx.Value(UserIDKey)，不是 ctx.Value(userIDKey{})（后者每次新建实例，类型相同但地址无关，实际能工作，但违背设计意图，且易误写）。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
传多个值时别链式调用 WithValue
连续三次 context.WithValue(ctx, k1, v1) → context.WithValue(ctx, k2, v2) → context.WithValue(ctx, k3, v3)，会创建三层嵌套 valueCtx，性能差、难维护、取值成本高。
替代方案是结构体打包：
- 定义不可变结构体：
type RequestMeta struct { UserID string; TraceID string; TenantID int64 } - 单次注入：
ctx = context.WithValue(ctx, metaKey{}, RequestMeta{UserID: uid, TraceID: tid}) - 字段必须不可变：不传指针；若需更新某字段，重建整个结构体再
WithValue，而非原地修改
这样内存分配更少，查找更快（O(1)），且下游只需一次断言就能拿到全部元数据。
HTTP 中间件里值“传不下去”的根本原因
你在中间件里写了 ctx = context.WithValue(r.Context(), key, val)，但 handler 里 ctx.Value(key) 还是 nil——因为 r.Context() 是只读副本，改完不绑定回请求对象，下游根本收不到。
必须显式用 r.WithContext(newCtx) 创建新请求：
newR := r.WithContext(ctx)- 再调
next.ServeHTTP(w, newR)
漏掉这一步，等于白设。另外注意：goroutine 分叉时也得显式传 ctx，go func() { ... }() 里用的还是外层旧变量，一旦 handler 返回，那个 ctx 可能已被 cancel 或丢弃。
真正难处理的不是“怎么加值”，而是“加完之后怎么让下游安全、高效地拿到”——链越深，取值成本越高；而传丢了或被意外替换（比如用了 context.Background() 替换原 ctx），值就彻底不可达了。
