应使用未导出字段的自定义类型（如 type userkey struct{}）作为 context key，避免字符串 key 冲突和类型不安全；推荐定义包级私有变量 var userkey = userkey{}，设值取值时复用该变量，并始终先判空再断言类型。
为什么不能直接用字符串当 Context Key
直接用 "user_id" 这种字符串做 context.WithValue 的 key，会导致不同包之间 key 冲突或类型不安全。Go 官方文档明确建议用自定义类型（未导出字段）作为 key，确保唯一性和类型隔离。
常见错误现象：context.Value("user_id") 返回 nil 或错误类型，因为另一个包也用了同名字符串 key，覆盖或没匹配上。
- key 类型必须是可比较的（如 struct、指针、int），但不能是 map/slice/func
- 推荐用未导出结构体，例如
type ctxKeyUser struct{}，避免外部误用 - 如果多个 key 逻辑相关，可定义一个私有包级变量（如
var userKey = ctxKeyUser{}），而非每次 new
怎么定义和使用安全的自定义 Context Key
核心是让 key 类型“不可被外部复现”——靠未导出字段实现。下面是最简可行写法：
type userKey struct{}
然后在需要传值的地方：
ctx := context.WithValue(parentCtx, userKey{}, 123)
id := ctx.Value(userKey{}).(int) // 注意类型断言
但更推荐把 key 封装成包级变量，避免重复构造：
- 定义：
var userKey = userKey{}（注意小写开头） - 设值：
ctx := context.WithValue(ctx, userKey, &User{ID: 123}) - 取值：
if u, ok := ctx.Value(userKey).(*User); ok { ... } - 不要在 key 类型里加字段（比如
type userKey struct{ name string }），否则每次 new 都是新实例，Value()查不到
取值时 panic 或返回 nil 的常见原因
最常踩的坑不是 key 定义，而是取值时类型断言失败或 key 不匹配：
-
ctx.Value(userKey)返回nil：上下文链中根本没调用过WithValue，或传了不同的 key 实例（比如用了userKey{}而不是包变量userKey） -
panic: interface conversion: interface {} is nil, not *User：没判空直接断言，应先用u, ok := ctx.Value(userKey).(*User) - 跨 goroutine 传递时忘记用
context.WithValue重新包装：子 goroutine 拿到的是原始 ctx，不是带值的 ctx - HTTP handler 中，中间件设置的值，在后续 handler 里取不到：确认是否用了
next.ServeHTTP(w, r.WithContext(ctx))更新 request context
要不要用 map[string]interface{} 包一层再塞进 Context
不要。这等于放弃类型安全，又回到字符串 key 的老路，还多一层解包开销。
Context 设计本意是传少量、生命周期明确、关键的请求级数据（如用户身份、请求 ID、超时控制）。如果你发现需要塞一堆字段，说明：
- 该数据不该走 Context，应该作为函数参数显式传递
- 或者该数据属于业务状态，应由 service 层管理，而不是靠 Context “隐式透传”
- Context 值过多会影响性能（底层是链表遍历），且难以追踪来源和生命周期
真正要传结构化数据时，定义专用 key 类型 + 专用 struct 类型，比泛型 map 更清晰、更可控。
