本文介绍一种基于闭包的优雅方式，将全局应用上下文（如 *core.context）安全、显式地注入到子目录中的 http 处理器函数中，避免使用全局变量，提升可测试性与可维护性。
本文介绍一种基于闭包的优雅方式，将全局应用上下文（如 *core.context）安全、显式地注入到子目录中的 http 处理器函数中，避免使用全局变量，提升可测试性与可维护性。
在 Go Web 开发中，常需将应用级上下文（如数据库连接池、配置、日志实例等）传递给各路由处理器。若直接依赖全局变量（如 var c *core.Context），虽能快速实现，但会带来严重问题：难以单元测试、违反依赖显式原则、引发并发安全隐患、降低模块复用性。
更优解是采用「闭包捕获上下文」模式——将处理器定义为一个接受上下文参数的工厂函数，返回符合 httprouter.Handle 签名的处理函数。这种方式既保持了 httprouter 的接口兼容性，又实现了依赖的显式注入。
✅ 正确实践：使用闭包封装上下文
在 token/token.go 中重写 Create 函数：
package token
import (
"net/http"
"github.com/julienschmidt/httprouter"
"yourapp/core" // 替换为实际路径
)
// Create 是一个处理器工厂函数：接收 *core.Context，返回 httprouter.Handle
func Create(ctx *core.Context) httprouter.Handle {
return func(w http.ResponseWriter, r *http.Request, params httprouter.Params) {
// ✅ 此处可安全使用 ctx —— 它来自闭包捕获，线程安全且作用域明确
userID := ctx.GetUserID() // 示例：从上下文中提取用户标识
token, err := ctx.TokenService().Generate(userID)
if err != nil {
http.Error(w, "Failed to create token", http.StatusInternalServerError)
return
}
w.Header().Set("Content-Type", "application/json")
w.Write([]byte(`{"token":"` + token + `"}`))
}
}在主路由配置文件中调用时，传入当前上下文即可：
// 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))
}⚠️ 注意事项与最佳实践
-
禁止全局变量反模式：原方案中 var c *core.Context 虽简单，但会使 token.Create 隐式依赖全局状态，导致：
- 单元测试需手动设置/清理 c，易出错；
- 并发请求下若 c 被意外覆盖（如中间件修改），将引发不可预测行为；
- 无法为不同路由注入不同上下文（如灰度环境隔离）。
闭包的安全性：Go 中闭包按值捕获外部变量（此处为指针 *core.Context），因此多个处理器实例共享同一上下文实例是安全且预期的；若需每个请求独立上下文（如含 request-scoped 数据），应在 handler 内部基于 r.Context() 构建新上下文，而非依赖初始化时传入的 ctx。
-
可扩展性提示：该模式天然支持依赖注入容器（如 Wire、Dig）。例如，未来可将 TokenService 作为参数传入 Create，进一步解耦实现细节：
func Create(svc TokenService) httprouter.Handle { ... }
✅ 总结
通过将处理器定义为「上下文感知的工厂函数」，你获得了：
- 清晰的依赖关系：谁需要什么，在调用处一目了然；
- 完美的可测试性：测试时可传入 mock context 或 test helper context；
- 零全局状态：消除隐式耦合，提升代码健壮性与协作效率；
- 无缝集成现有框架：完全兼容 httprouter、Gin、Echo 等支持函数式注册的路由器。
这不是“多写几行代码”的权衡，而是以微小抽象换取长期工程健康度的关键决策。
