Go中间件链的核心是func(http.Handler) http.Handler函数签名，通过嵌套调用实现m1→m2→m3→final的顺序执行；每个中间件须显式调用next.ServeHTTP(w, r)才能继续，否则中断；支持Context传递与错误短路。
在 Go 中管理中间件链，核心是利用函数式编程思想：每个中间件是一个接收 http.Handler 并返回新 http.Handler 的函数，通过嵌套或链式调用实现顺序执行。关键不在于“框架依赖”，而在于理解 func(http.Handler) http.Handler 这一签名如何串联逻辑。
中间件的基本结构与顺序原理
Go 的 HTTP 中间件本质是“包装器”——它不直接处理请求，而是控制何时、以何种顺序把请求交给下一个处理器。顺序由嵌套层级决定：最外层中间件最先执行，也最先决定是否放行；最内层（通常是最终 handler）最后执行。
- 中间件函数签名固定为：
func(http.Handler) http.Handler - 调用时按“从外到内”顺序传入：比如
m1(m2(m3(final)))，则执行顺序是 m1 → m2 → m3 → final - 每个中间件内部必须显式调用
next.ServeHTTP(w, r)才能继续链路；不调用即中断
手动组合中间件（无框架）
无需第三方库，用纯 Go 就可清晰构建可读的中间件链。推荐将组合逻辑提取为变量或函数，避免过深嵌套：
final := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("OK"))
})
handler := logging(middleware1(auth(middleware2(final))))
http.ListenAndServe(":8080", handler)
更清晰的做法是逐层赋值：
h := final
h = middleware2(h)h = auth(h)h = middleware1(h)h = logging(h)- 启动服务：
http.ListenAndServe(":8080", h)
支持上下文传递的增强型中间件
原生 http.Handler 不携带 context，但实际开发常需跨中间件传递数据（如用户 ID、请求 ID）。推荐升级为接收 http.Handler 并返回 http.Handler 的闭包，内部使用 r = r.WithContext(...) 注入值：
func withRequestID(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
id := uuid.New().String()
ctx := context.WithValue(r.Context(), "request_id", id)
r = r.WithContext(ctx)
next.ServeHTTP(w, r)
})
}
下游中间件或最终 handler 可通过 r.Context().Value("request_id") 安全获取。
错误处理与
短路控制
短路控制中间件链中任一环节可提前写响应并终止流程，这是实现鉴权失败、参数校验不通过等场景的关键：
- 在中间件中检查条件，不满足时直接
http.Error(w, "Forbidden", http.StatusForbidden) - 避免调用
next.ServeHTTP(...)，链路即中断 - 若需统一错误处理，可封装一个
errorHandler中间件放在最外层，用defer/recover捕获 panic，或配合自定义 error 类型做分类响应
