本文介绍一种符合 go 语言惯用法的上下文传递方案：通过闭包封装子包 http 处理器，使 *core.context 在不依赖全局变量的前提下，安全、显式、可测试地注入到深层目录（如 token/）的路由处理函数中。
本文介绍一种符合 go 语言惯用法的上下文传递方案：通过闭包封装子包 http 处理器，使 *core.context 在不依赖全局变量的前提下，安全、显式、可测试地注入到深层目录（如 token/）的路由处理函数中。
在 Go Web 开发中，将应用级上下文（如数据库连接池、配置、日志实例等）传递给各层处理器是一个常见且关键的设计问题。直接使用全局变量（如示例中的 var c *core.Context）虽能快速实现，但会带来严重缺陷：破坏函数纯度、阻碍单元测试、引发并发安全隐患，并使依赖关系隐式化、难以追踪。
推荐做法是采用依赖注入 + 闭包封装模式——即让子包处理器（如 token.Create）不再是一个静态函数，而是接受上下文作为参数并返回一个符合 httprouter.Handle 类型的闭包函数。
✅ 正确实现方式（推荐）
在 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：数据库、缓存、日志等均已就绪
log := ctx.Logger.With("handler", "token.create")
log.Info("received token creation request")
// 示例：调用业务逻辑（同样可注入 ctx）
result, err := createTokenService(ctx, r)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusCreated)
// ... 序列化 result
}
}
// 辅助业务函数（可进一步解耦，便于测试）
func createTokenService(ctx *core.Context, r *http.Request) (interface{}, error) {
// 使用 ctx.DB, ctx.Config 等执行具体逻辑
return map[string]string{"token": "abc123"}, nil
}在主路由配置文件中调用时，显式传入上下文：
// router.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)) // 同样适用于其他 handler
}⚠️ 注意事项与最佳实践
- 避免全局变量：var c *core.Context 违反单一职责与可测试性原则；在多 goroutine 场景下还可能因竞态导致 context 被意外覆盖。
- 保持 handler 纯净：闭包内部应专注 HTTP 协议层逻辑（解析请求、写响应），核心业务应下沉至独立 service 层，并统一接收 *core.Context。
- 支持中间件链式注入：若需动态增强 context（如添加 traceID、用户身份），可在 ConfigureRouter 中先构建增强后的 context 再传入 token.Create()。
- 兼容性保障：httprouter.Handle 类型定义为 func(http.ResponseWriter, *http.Request, httprouter.Params)，本方案完全匹配其签名，无需修改路由库。
✅ 总结
该模式以极小的语法成本实现了高内聚、低耦合的架构设计：上下文生命周期清晰可控、子包无隐式依赖、所有 handler 均可独立单元测试（只需构造 mock context）、未来迁移至其他路由库（如 Gin、Chi）时也仅需微调闭包返回类型。这是 Go 生态中被广泛验证的工程实践。
