本文介绍一种符合 go 语言最佳实践的方式：通过闭包将 *core.context 注入子包的 http 处理器，避免全局变量依赖，提升代码可测试性与模块隔离性。
本文介绍一种符合 go 语言最佳实践的方式：通过闭包将 *core.context 注入子包的 http 处理器，避免全局变量依赖，提升代码可测试性与模块隔离性。
在基于 httprouter 构建的 Go Web 应用中，常需在路由处理器中访问应用级上下文（如配置、数据库连接池、日志实例等）。若直接使用全局变量（如 var c *core.Context）暴露上下文，虽能快速实现功能，但会带来严重问题：难以单元测试、违反依赖注入原则、导致包间隐式耦合、并发下存在竞态风险。
更优解是采用「函数工厂」（function factory）模式：将 token.Create 改造为一个接收 *core.Context 并返回 httprouter.Handle 的高阶函数。这种方式利用 Go 的闭包特性，在 handler 创建时捕获上下文，既保持了子包（如 token/）的独立性，又无需修改 httprouter 的调用约定。
以下是具体实现：
// 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 —— 它来自 ConfigureRouter 的传入参数
// 例如：log := ctx.Logger.With("handler", "token.Create")
// db := ctx.DB // 获取数据库实例
// token, err := generateToken(r, db)
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
w.Write([]byte(`{"status":"success"}`))
}
}在主路由配置文件中调用时，只需传入上下文实例：
// router/router.go
func ConfigureRouter(ctx *core.Context, router *httprouter.Router) {
// ✅ 无全局变量污染，ctx 生命周期清晰可控
router.POST("/v1/tokens/create", token.Create(ctx))
// 可继续注册其他带上下文的处理器
router.GET("/v1/users/:id", user.Get(ctx))
}✅ 优势总结：
- 可测试性强：token.Create(ctx) 返回的 handler 可直接在测试中传入 mock context，无需启动 HTTP 服务；
- 依赖显式化：token 包不再隐式依赖全局状态，所有外部依赖均通过参数声明；
- 线程安全：每个 handler 实例持有其专属上下文副本，无共享变量风险；
- 符合 httprouter 设计哲学：完全兼容原生 Handle 类型，不引入中间层或 wrapper。
⚠️ 注意事项：
- 切勿在闭包内捕获 *core.Context 的可变字段（如未加锁的 map），若上下文本身含状态，请确保其并发安全；
- 若上下文结构庞大且仅需部分字段，建议提取接口（如 type Logger interface{ Info(...); Error(...) }），进一步降低耦合；
- 避免在 Create(ctx) 内执行耗时初始化逻辑——它会在每次路由注册时运行，而非每次请求。应将初始化移至 ctx 构建阶段或 handler 内按需懒加载。
该模式不仅适用于 token 子包，还可推广至所有业务子模块（如 user, order, payment），是构建可扩展、易维护 Go Web 服务的核心实践之一。
