context.withvalue 的正确用法是：key 必须为自定义类型（如 type useridkey struct{}），不可用字符串字面量；只传轻量不可变元数据（如 string、int64）；http 中间件需 r = r.withcontext(newctx) 向下传递；取值必须用 v, ok := ctx.value(key).(type) 判断；goroutine 中 defer cancel() 无效，应传入 ctx 并监听 done()。
context.WithValue 的正确写法：key 必须是自定义类型
直接用 "user_id" 这种字符串当 key，十有八九会撞车——不同包里都用同一个字符串 key，后写的覆盖前写的，还查不出原因。Go 的 context.Value 要求 key 可比较，而字符串虽可比较，但跨包无隔离性。
- 必须定义未导出的空结构体或新类型，例如：
type userIDKey struct{}或type ctxKey string（注意不是string） - key 类型要统一导出，比如
var UserIDKey = userIDKey{}，所有中间件和 handler 都用它 - 千万别在多个地方分别定义
type Key string—— 它们类型不等价，ctx.Value(k1)永远拿不到ctx.Value(k2)的值
传什么值？只传轻量、不可变的元数据
context.WithValue 不是函数参数替代品，也不是共享状态的仓库。它设计初衷只是透传请求生命周期内的“只读标签”，比如 traceID、用户 ID、语言偏好。传结构体指针？传 map？传 *sql.Tx？全都不合适。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 推荐传
string、int64、bool等基本类型，或封装好的只读接口（如interface{ GetTraceID() string }） - 若必须传对象，优先考虑把字段拆成独立 key，或改用函数参数/结构体字段传递
- 传指针极易引发并发竞争：goroutine A 修改了结构体字段，goroutine B 读到脏值，且无法追溯谁改的
中间件里怎么安全塞值并往下传？
HTTP 中间件里调 context.WithValue(r.Context(), key, val) 后，如果不重新绑定到请求上，下游 handler 根本收不到——因为 r.Context() 是只读副本，不会自动更新。
- 必须用
r = r.WithContext(newCtx)创建新请求对象，再传给next.ServeHTTP(w, r) - 取值时永远用
v, ok := ctx.Value(UserIDKey).(string)，不能省略ok判断，否则类型断言失败直接 panic - 建议封装读取函数，比如：
func GetUserID(ctx context.Context) (string, bool) { v, ok := ctx.Value(UserIDKey).(string); return v, ok && v != "" }
为什么 defer cancel() 在 goroutine 里会失效？
在 handler 启动 goroutine 时，如果在 goroutine 内部写 defer cancel()，cancel 函数可能永远不执行——因为 goroutine 生命周期独立于 handler，而 defer 只在函数返回时触发。
- goroutine 应该接收外部传入的
ctx，并在内部监听ctx.Done()主动退出 - 不要在 goroutine 里调
context.WithCancel(context.Background())，这会切断父链，上游超时信号传不进来 - 需要手动控制取消时，应在 handler 入口处调
ctx, cancel := context.WithTimeout(r.Context(), 5*time.Second)，然后把ctx传给 goroutine，cancel在 handler 结束前显式调用（或 defer）
context.WithValue，而是判断“这个值到底该不该进 context”。大多数业务字段，放在 handler 参数里、service 结构体字段里、甚至直接作为函数入参，都比塞进 context 更清晰、更易测、更少意外。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
