安全绑定 core.Context 的正确方式是将其作为参数传入工厂函数（如 token.Create）并返回 httprouter.Handle，利用闭包保证线程安全；严禁全局变量存储或混用 request.Context() 与 core.Context。
httprouter.Handle 怎么安全绑定 *core.Context
直接在子包里用全局变量存 *core.Context 是最常见也最危险的做法——它让测试无法 mock、并发下可能被覆盖、模块间耦合死死咬住。正确路径只有一条：把 token.Create 这类函数改造成接收 *core.Context 并返回 httprouter.Handle 的工厂函数。
闭包捕获的 ctx 是线程安全的，每个 handler 实例独享一份引用，不会交叉污染。注意工厂函数必须导出（首字母大写），且签名严格匹配 func(http.ResponseWriter, *http.Request, httprouter.Params)。
- 别在 handler 内部再调用
context.WithCancel(r.Context())—— 那是请求级上下文，和应用级*core.Context用途不同，混用会掩盖取消信号来源 - 子包 import 路径要写对，比如
"yourapp/core"，不能写成"./core"，否则 vendor 或 go mod tidy 时容易断链 - 如果
*core.Context本身包含sync.Mutex或其他同步原语，确保所有方法都是并发安全的；否则在 handler 中调用前需自行加锁
request.Context() 和 *core.Context 混用时的典型错误
r.Context() 是标准库提供的请求生命周期上下文，带取消通道和超时控制；*core.Context 是你应用层封装的依赖集合（DB、Config、Logger）。两者必须分层使用，不能互相替代或强行合并。
常见错误是把 *core.Context 塞进 context.WithValue(r.Context(), key, value) —— 这不仅浪费内存（深拷贝风险），还会让下游服务误以为这是请求元数据，破坏职责边界。
立即学习“go语言免费学习笔记（深入）”；
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- ✅ 正确做法：
r.Context()传给 DB 查询、RPC 调用等需要响应中断的底层操作；*core.Context用于获取配置、日志实例、业务服务对象 - ❌ 错误示范：
ctx := context.WithValue(r.Context(), "appCtx", coreCtx)—— 取值时类型断言易 panic，且违反 context.Value 应只存轻量不可变 metadata 的原则 - 如果真要透传用户 ID、trace ID 等，定义强类型 key：
type userIDKey struct{}，再用context.WithValue(r.Context(), userIDKey{}, userID)
defer cancel() 忘记调用会导致 goroutine 泄漏
只要用了 context.WithTimeout 或 context.WithCancel，就必须配对 defer cancel()。漏掉这句，超时或取消信号发不出去，goroutine 会卡在 上永远等待，最终耗尽系统资源。
尤其在嵌套 handler 场景下（比如中间件包装原始 handler），cancel 函数的作用域容易被忽略。建议所有带 timeout 的逻辑都封装成独立函数，并把 cancel 作为返回值之一显式暴露。
- 不要在 handler 里写
go func() { ... }()后忘记传入r.Context()—— 子 goroutine 拿不到父级取消信号，变成孤儿协程 - 数据库查询、HTTP client 调用必须传
r.Context()，否则超时设置无效；但不要传*core.Context，除非该方法明确设计为接受它 - 检查日志中是否频繁出现
context canceled或context deadline exceeded—— 如果比例异常高，说明 cancel 调用时机或超时阈值不合理
测试时如何隔离 *core.Context 依赖
单元测试跑不起来，往往是因为 handler 直接依赖全局 *core.Context 实例。改成工厂函数后，测试就简单了：构造一个 mock *core.Context，传给 token.Create(mockCtx)，再调用返回的 handler 即可。
mock 对象不需要实现全部方法，只 stub 测试用到的几个，比如 DB.QueryRow()、Logger.Info()。重点验证 handler 是否正确调用了这些方法，而不是结果内容。
- 避免在测试中 new 一个真实
*core.Context—— 它可能初始化 DB 连接池或加载配置文件，拖慢测试速度且引入不确定性 - 如果 handler 内部调用了
r.Context()相关逻辑（如超时判断），用httptest.NewRequest("GET", "/", nil).WithContext(...)构造带 mock context 的 request - 注意
httprouter.Params是值类型，测试时直接构造httprouter.Params{"id": {"123"}}即可，无需 mock
*core.Context 中每个字段（尤其是 DB、Cache）本身是否线程安全。Go 的 sql.DB 和 redis.Client 天然是并发安全的，但你自己写的 service 层如果用了未同步的 map 或 slice，闭包绑定后反而放大了竞态风险。 
