本文介绍一种符合 go 语言惯用法的解决方案：通过闭包将应用上下文（*core.context）预绑定到 http 处理函数，避免全局变量，实现跨包依赖注入，提升代码可测试性与可维护性。
本文介绍一种符合 go 语言惯用法的解决方案：通过闭包将应用上下文（*core.context）预绑定到 http 处理函数，避免全局变量，实现跨包依赖注入，提升代码可测试性与可维护性。
在构建模块化 Go Web 应用时，常需将主应用上下文（如配置、数据库连接池、日志实例等）传递至各业务子包（如 token、user）。若采用全局变量（如 var c *core.Context）虽能快速访问，但会破坏封装性、阻碍单元测试，并引发并发安全隐患——尤其在多实例或热重载场景下极易出错。
推荐做法是将上下文作为依赖显式注入，利用 Go 的高阶函数特性，以闭包方式预绑定上下文，生成符合 httprouter.Handle 签名的处理器函数。
✅ 正确实现：闭包注入上下文
在 token/token.go 中，重构 Create 函数为工厂函数：
package token
import (
"net/http"
"github.com/julienschmidt/httprouter"
"yourapp/core" // 替换为实际路径
)
// Create 是一个上下文感知的处理器工厂
func Create(ctx *core.Context) httprouter.Handle {
return func(w http.ResponseWriter, r *http.Request, params httprouter.Params) {
// ✅ 此处可安全使用 ctx：日志、DB、配置等皆可用
ctx.Logger.Info("Creating token...")
// 示例：从上下文获取数据库实例并执行操作
// db := ctx.DB
// token, err := db.CreateToken(...)
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
w.Write([]byte(`{"status":"success"}`))
}
}在主路由配置文件中调用时，传入当前上下文即可：
func ConfigureRouter(ctx *core.Context, router *httprouter.Router) {
// ✅ 上下文被静态绑定到 handler，无全局状态污染
router.POST("/v1/tokens/create", token.Create(ctx))
// 同样适用于其他路由
// router.GET("/v1/users/:id", user.Get(ctx))
}⚠️ 注意事项与最佳实践
- 禁止全局变量反模式：原方案中 var c *core.Context 虽简单，但导致包级状态耦合，使 token 包无法独立测试（需手动设置 c），且在并发请求中可能因竞态导致上下文错乱。
- 闭包生命周期安全：Go 中闭包捕获的变量（如 ctx）在其引用的 handler 存活期间始终有效；httprouter 每次请求均调用新生成的 handler 实例，因此无需担心上下文泄漏。
-
可扩展性设计：该模式天然支持依赖分层。例如，若 token 包还需 cache 或 mailer，可扩展工厂函数签名：
func Create(ctx *core.Context, cache *redis.Client, mailer *Mailer) httprouter.Handle { ... } -
测试友好：单元测试时可直接传入 mock 上下文，无需启动完整服务：
func TestTokenCreate(t *testing.T) { mockCtx := &core.Context{Logger: testLogger{}} handler := token.Create(mockCtx) // 构造 fake request 并调用 handler... }
✅ 总结
将上下文作为参数注入处理器工厂函数，是 Go Web 开发中解耦、可测、可维护的黄金实践。它摒弃了脆弱的全局状态，以清晰的数据流替代隐式依赖，让每个子包明确声明其运行时需求——这不仅是技术选择，更是工程素养的体现。
