必须用未导出私有类型（如type useridkey struct{}）作key，禁用字符串或int字面量；取值须用v, ok := ctx.value(key).(t)双返回值判断；http中间件需r = r.withcontext(ctx)显式绑定新ctx。
不能靠全局变量或闭包，必须用 context.WithValue + 自定义 key 类型。任何用 "user_id" 或 int(1) 当 key 的做法，在多中间件、多模块场景下必然导致值覆盖或类型断言 panic。
为什么 string/int 作 context key 是危险的
Go 的 context.WithValue 不检查 key 类型是否重复，只做指针或字面量比较。两个不同包都用 "auth_user" 当 key，后写的会覆盖先写的；用 int 更糟——ctx.Value(1) 可能取到任意层塞进去的值。
- 官方明确要求：key 应是「未导出的私有类型」，保证包级唯一性
- 类型断言失败时 panic 不是偶然——
user := ctx.Value(userKey).(User)若 key 冲突，实际存的是string，运行时报panic: interface conversion: interface {} is string, not main.User - 静态分析工具（如
staticcheck）会直接报SA1029: using a string or int as context key
如何定义和使用安全的 context key
key 必须是包内私有、不可比较、不导出的空结构体，且变量名带包前缀避免跨包重名。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 在认证模块定义：
type userCtxKey struct{}，然后var userCtxKey = userCtxKey{} - 绝不要导出该类型或变量，也不要在其他包里复用同名结构体——哪怕长得一样，类型也不同
- 注入时：
ctx := context.WithValue(r.Context(), userCtxKey, &User{ID: 123, Role: "admin"}) - 取值时必须显式类型断言并检查：
if user, ok := ctx.Value(userCtxKey).(*User); ok { ... }，ok为 false 就说明上游没注入或注入错了类型
HTTP 中间件中透传凭证的典型陷阱
中间件修改 r.Context() 后，必须用 r.WithContext(newCtx) 构造新请求对象传给 next，否则下游 handler 拿到的还是原始 context。
- 错误写法：
next.ServeHTTP(w, r)——r还是原来的，ctx没更新 - 正确写法：
next.ServeHTTP(w, r.WithContext(ctx))，其中ctx是注入了用户信息的新 context - 如果用了 gorilla/mux 等路由库，确保它调用
HandlerFunc时传入的是已更新 context 的 request，而不是缓存副本 - 别在中间件里 defer
cancel()后又往 context 塞值——cancel()会让 context.Done() 关闭，但 value 仍可读；不过逻辑上已“结束”的 context 不该再塞业务数据
value 本身也要防竞态和误修改
传进 context 的值必须是不可变的，或者至少是只读语义。传指针没问题，但绝不能传可变 map/slice 并让下游随意改。
- 推荐传
*User或User结构体指针，字段设为 unexported（如id int而非ID int），提供 getter 方法控制访问 - 禁止传
map[string]interface{}或[]string——下游协程可能并发写，触发fatal error: concurrent map writes - 如果必须传集合，用
sync.Map或封装成只读接口，比如func Roles() []string返回 copy 后的切片
最易被忽略的一点：context value 是单向传递链，不是广播总线。一个 goroutine 启动多个子 goroutine 时，每个都要显式把带 value 的 context 传进去——go worker(ctx)，而不是 go worker(r.Context())。漏传一次，下游就拿不到凭证。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
