go虽无装饰器语法糖，但http中间件通过func(http.handler) http.handler签名实现装饰器模式，需用http.handlerfunc显式转换闭包，正确调用next.servehttp()并按需包装responsewriter。
Go 里没有装饰器语法，但 http.Handler 链天然支持装饰
Go 没有 Python 那种 @decorator 语法糖，但 HTTP 中间件就是装饰器模式的典型实践：每个中间件接收一个 http.Handler，返回另一个 http.Handler，在调用前后插入逻辑。核心在于函数签名统一：func(http.Handler) http.Handler。
常见错误是直接在中间件里写死路由或响应，绕过 next.ServeHTTP()，导致请求中断。正确做法永远是显式调用下一层：
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
log.Printf("START %s %s", r.Method, r.URL.Path)
next.ServeHTTP(w, r) // 必须调用，否则链断裂
log.Printf("END %s %s", r.Method, r.URL.Path)
})
}
中间件顺序决定执行时机，wrap(wrap(handler)) 是关键
中间件叠加本质是函数嵌套：外层中间件包裹内层，所以调用顺序和包装顺序相反。比如 auth(logging(handler))，实际执行是：auth → logging → handler → logging → auth。
- 想让日志记录完整生命周期（含 auth 耗时），就把
loggingMiddleware包最外层 - 想让 auth 在日志之前拦截非法请求，就让它包在 logging 里面
- 不要用“中间件数组 + for 循环”方式拼接，那会丢失闭包语义，容易引发变量复用 bug
http.HandlerFunc 是桥梁，不转换就无法接入标准库
标准库只认 http.Handler 接口，而你写的闭包默认不是该类型。必须用 http.HandlerFunc 显式转换，否则编译报错：cannot use func literal (type func(http.ResponseWriter, *http.Request)) as type http.Handler。
立即学习“go语言免费学习笔记（深入）”；
这个转换不只是语法糖——它实现了 ServeHTTP 方法，让闭包能被标准路由（如 http.ServeMux）识别。漏掉这步，中间件根本跑不起来。
示例对比：
// ❌ 错误：未转换，类型不匹配
func badMiddleware(next http.Handler) http.Handler {
return func(w http.ResponseWriter, r *http.Request) { // 类型是 func(...)，不是 http.Handler
next.ServeHTTP(w, r)
}
}
// ✅ 正确：用 http.HandlerFunc 包一层
func goodMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
next.ServeHTTP(w, r)
})
}
真实项目中常踩的坑：中间件里修改 ResponseWriter 不生效
很多中间件想改状态码、加 header 或劫持响应体，但直接对原始 w http.ResponseWriter 操作无效——因为下游 handler 可能已写入部分响应，或使用了 http.Hijacker 等底层接口。
- 要捕获响应，得用包装型
ResponseWriter（如自定义responseWriter结构体，实现WriteHeader/Write方法） - 别在中间件里调用
w.WriteHeader(401)后还继续调用next.ServeHTTP()，HTTP 状态码一旦写出就不可逆 - 如果依赖第三方中间件（如
gorilla/handlers.CompressHandler），注意它内部可能已包装过ResponseWriter，你的包装需兼容其接口
复杂点在于：每个中间件对 ResponseWriter 的改造都可能破坏其他中间件的假设。没做透 wrapper 层级兼容，上线后就容易出现 header 丢失、压缩失效、日志状态码恒为 200 这类静默故障。
