Golang中间件链管理：顺序调用与组合技巧

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)

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)
    })
}