context.WithValue 返回新 context 而非修改原对象，需显式传递给下游；key 必须用不可比较的私有类型（如 struct{}），value 应为不可变小数据，取值须用双返回值断言防 panic。
context.WithValue 返回新 context，不改原对象
调用 context.WithValue 不会修改传入的 context，而是返回一个全新的、带键值对的 valueCtx。常见错误是写了 ctx = context.WithValue(ctx, key, val) 却没把新 ctx 传给下游函数，导致后续 ctx.Value(key) 拿不到值。
HTTP handler 中尤其容易踩坑：必须显式更新 request 的 context，例如 r = r.WithContext(newCtx)；只改局部变量 ctx 对 r.Context() 完全无效。
- 每次调用都生成新节点，父子 context 是链表关系，不是共享 map
- 若在 goroutine 启动前忘了传新 context，子协程拿到的仍是旧 context（空或无该 key）
- 中间件里反复
WithValue套娃 5 层以上，Value查找会退化为 O(n)，高频日志打点时可观测到延迟上升
key 必须用自定义类型，别用 string
用 string 当 key 是最常被线上 panic 的原因——不同包可能定义同名字符串 key，互相覆盖；编译器也无法检查类型安全。官方明确建议用未导出的私有结构体类型，比如 type userIDKey struct{}。
key 类型必须满足 Go 的 comparable 约束，所以不能用 map、slice、func 或含这些字段的 struct。value 同理，不可传 map[string]interface{} 或 *sql.Tx。
立即学习“go语言免费学习笔记（深入）”；
- 推荐写法：
var userKey = struct{}{}或type userKey struct{}，然后用userKey{}作 key - 不要导出 key 类型（如
type UserKey struct{}），避免跨包冲突 - value 优先选
string、int64、time.Time这类不可变小数据
取值必须用 v, ok := ctx.Value(key).(T) 防 panic
ctx.Value(key) 返回 interface{}，直接强转 v := ctx.Value(key).(string) 在 key 不存在或类型不匹配时会 panic。生产代码必须用双返回值断言，且要检查 ok 和零值。
典型场景如从 context 提取 traceID 或用户 ID，漏掉判断会导致 handler 直接崩溃，而不是返回 401 或打 warning 日志。
- 封装提取函数更安全，例如：
func TraceIDFromCtx(ctx context.Context) (string, bool) { v, ok := ctx.Value(traceKey).(string); return v, ok && v != "" } - 别在 for 循环里反复调用
ctx.Value，提前提取到局部变量即可 - 如果 value 是自定义 struct，确保所有字段都可比较，并定义清晰的零值行为（比如
ID == 0表示缺失）
只传请求生命周期内不变的元数据
context.Value 不是通用状态容器。它适合存 requestID、userID、traceID 这类从入口解析一次、全程只读、随请求消亡的数据。一旦你发现需要“更新” context 里的某个字段（比如语言偏好、灰度分组），说明设计已偏离本意。
传结构体指针能工作，但极易引发 data race：多个 goroutine 并发读写同一内存地址，go test -race 会立刻报错；更隐蔽的问题是某中间件悄悄改了字段，上游却毫无感知。
- 高频变更状态 → 改用函数参数或结构体成员
- 需并发读写 → 用
sync.Map或atomic.Value封装后存指针（但已绕过 context 原始语义） - 敏感信息（如 token、密码）别塞进 context，避免被日志自动打印或意外透传
WithValue，下游取到的永远是最后一次注入的值，而非最初来源。 
