Go HTTP中间件本质是func(http.Handler) http.Handler的链式调用，通过包装Handler实现请求前/后处理，必须显式调用next.ServeHTTP，且需用http.HandlerFunc转换闭包以满足接口要求。
http.Handler 是 Golang 微服务中间件的立足点，不是抽象概念，而是可直接组合、调试、替换的具体类型。它决定了中间件必须是函数套函数，而不是配置项或注解。
中间件本质就是包装 http.Handler 的函数
它不改变路由逻辑，也不侵入业务 handler，只做“前后夹击”：在 next.ServeHTTP 前处理请求，在之后处理响应。常见错误是忘记调用 next.ServeHTTP，导致请求静默丢失；或者在 panic 后没恢复，整个链路崩溃。
- 必须返回
http.Handler，不能是func(http.ResponseWriter, *http.Request)（除非显式转成http.HandlerFunc） - 所有状态传递必须通过
context.Context，比如r.WithContext(ctx)，绝不能用全局变量或闭包变量跨中间件存数据 - 顺序敏感：先注册的中间件，最先执行；
LoggingMiddleware(AuthMiddleware(handler))中，日志会记录认证前的原始请求
手动组合中间件容易漏掉 next.ServeHTTP 调用
嵌套写法看着清晰，但每层都得手动传 next，稍一疏忽就断链。比如下面这个典型错误：
func authMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if !isValidToken(r) {
http.Error(w, "Forbidden", http.StatusForbidden)
// 忘了 return，下面 next.ServeHTTP 还会执行 → 重复写 header 报错
}
next.ServeHTTP(w, r) // 即使鉴权失败也执行？显然不对
})
}
正确做法是鉴权失败后立即 return，且确保 next.ServeHTTP 只在合法路径下触发：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 每个中间件内部都要有明确的“放行”或“拦截”分支
- 拦截时必须终止响应（如
http.Error或w.WriteHeader + w.Write），并return - 不要依赖 defer 在 panic 后补救 —— defer 无法捕获已写出的 response header
Gin 框架的 gin.HandlerFunc 和标准库不是一回事
你不能把标准库写的 func(http.Handler) http.Handler 直接塞进 router.Use()。Gin 的中间件签名是 func(*gin.Context)，底层做了适配封装。混用会导致 panic：“interface conversion: interface {} is *http.request, not *gin.Context”。
立即学习“go语言免费学习笔记（深入）”；
-
gin.Use(loggingMiddleware)里的loggingMiddleware必须是func(*gin.Context)类型 - 标准库中间件想复用到 Gin，得重写或用
gin.WrapH包装，但性能有损耗 - Gin 的
c.Next()等价于标准库的next.ServeHTTP，但它隐含了上下文生命周期管理
中间件里读写 body 是个危险操作
*http.Request.Body 是单次读取流，中间件里 ioutil.ReadAll(r.Body) 之后，下游 handler 再读就是空字节。这不是 bug，是 Go HTTP 的设计约束。
- 如果要校验或解析 body（如 JWT payload、JSON 参数），必须用
io.NopCloser重建 Body，并把内容存到context.Context里供后续使用 - 修改 body（如加签、脱敏）需谨慎：务必重置
Content-Length头，否则 client 可能卡住等待剩余字节 - 大文件上传场景下，中间件里 buffer 全部 body 容易 OOM，应改用 streaming 方式校验（如检查前几个字节）
context.Context —— 其他任何“捷径”都会在高并发下暴露。 
