本文介绍一种符合 go 函数式风格的上下文传递方案：通过闭包将 *core.context 注入到子目录中的 http 处理器，避免全局变量、确保依赖显式化与测试友好性。
本文介绍一种符合 go 函数式风格的上下文传递方案：通过闭包将 *core.context 注入到子目录中的 http 处理器，避免全局变量、确保依赖显式化与测试友好性。
在构建分层 Go Web 应用时，常需将应用级上下文（如配置、数据库连接池、日志实例等）传递给各业务处理器。若采用全局变量（如示例中的 var c *core.Context）方式共享上下文，虽能快速实现，但会带来严重隐患：破坏函数纯度、阻碍单元测试、引发并发竞争风险，且使依赖关系隐式化，降低代码可维护性。
推荐做法是将上下文作为参数提前绑定到处理器构造过程，即利用 Go 的闭包特性，让子模块导出一个“上下文感知的处理器工厂函数”。以 token.Create 为例，应将其重构为接收 *core.Context 并返回 httprouter.Handle 的高阶函数：
// token/token.go
package token
import (
"net/http"
"github.com/julienschmidt/httprouter"
"yourapp/core" // 替换为实际路径
)
// Create 是一个处理器工厂：接收 Context，返回可注册的 httprouter.Handle
func Create(ctx *core.Context) httprouter.Handle {
return func(w http.ResponseWriter, r *http.Request, params httprouter.Params) {
// ✅ 此处可安全使用 ctx 进行业务逻辑
// 例如：ctx.DB.Query(...), ctx.Logger.Info("token created"), ctx.Config.Get("jwt.secret")
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
w.Write([]byte(`{"status":"success"}`))
}
}在主路由配置处，只需传入当前上下文即可获得绑定后的处理器：
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
// main.go 或 router/config.go
func ConfigureRouter(ctx *core.Context, router *httprouter.Router) {
// ✅ 显式注入，无全局状态
router.POST("/v1/tokens/create", token.Create(ctx))
// 可继续注册其他上下文感知路由
router.GET("/v1/tokens/:id", token.Get(ctx))
}✅ 优势总结：
- 依赖显式化：每个处理器明确声明其所需上下文，提升可读性与可追踪性；
- 测试友好：单元测试中可自由传入 mock context，无需重置全局变量；
- 并发安全：无共享可变状态，天然规避 goroutine 竞态；
- 解耦清晰：token 包不依赖全局变量或 init 逻辑，仅依赖接口契约（*core.Context）；
- 符合 httprouter 设计哲学：Handle 类型本就支持闭包封装，此方案是对框架特性的自然延伸。
⚠️ 注意事项：
- 确保 core.Context 结构体本身是线程安全的（如内部字段为只读或已加锁）；
- 若上下文含大量临时数据，注意闭包捕获可能延长对象生命周期，必要时做轻量拷贝；
- 避免在 Create(ctx) 内部执行耗时初始化——应提前在 ConfigureRouter 中完成，保持处理器函数轻量。
该模式可推广至所有子模块（如 user, order, payment），形成统一、可扩展的上下文传递规范，是构建健壮 Go Web 服务的重要实践之一。
