1. 中间件概念与 Go 中的实现

1.1 中间件设计模式

中间件（Middleware）是一种在请求处理管道中插入额外处理逻辑的设计模式。它允许开发者在不修改核心业务代码的前提下，横切关注点（如日志、鉴权、限流、错误恢复）与主流程解耦。

中间件的核心特征可以归纳为以下三点：

  • 链式传递：每个中间件接收请求，执行预处理，调用下一个处理器，再执行后处理。
  • 职责单一：每个中间件只负责一个横切关注点，便于组合与复用。
  • 可插拔：中间件可以按任意顺序组装，不影响核心业务逻辑。
设计启示：中间件模式本质上是“装饰器模式”在服务端请求处理场景的变体。Go 语言通过函数签名与闭包，天然支持这种链式组合。

1.2 Go HTTP 中间件基础

Go 标准库 net/http 没有内置“中间件”关键字，但通过 http.Handler 接口与函数式编程，可以轻松构建中间件链。一个典型的 Go HTTP 中间件是一个接收 http.Handler 并返回新的 http.Handler 的函数：

type Middleware func(http.Handler) http.Handler

这种签名使得中间件可以嵌套组合，形成请求处理管道。下面是一个完整的日志中间件示例：

func LoggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        log.Printf("[%s] %s %s", r.Method, r.URL.Path, r.RemoteAddr)
        next.ServeHTTP(w, r)
        log.Printf("[%s] %s completed in %v", r.Method, r.URL.Path, time.Since(start))
    })
}

1.3 net/http Handler 接口

理解中间件必须从 http.Handler 接口开始。该接口是 Go HTTP 处理的核心契约：

接口/类型 签名 说明
http.Handler ServeHTTP(ResponseWriter, *Request) 所有 HTTP 处理器的核心接口
http.HandlerFunc func(ResponseWriter, *Request) 函数适配器，将普通函数转换为 Handler
http.ServeMux ServeHTTP + Handle(pattern, handler) 默认路由复用器，实现 Handler 接口

中间件链的构建本质上是将多个 http.Handler 通过闭包串联。下图展示了请求在中间件链中的流转路径：

Go HTTP 中间件链请求流转 客户端请求 日志中间件 鉴权中间件 限流中间件 业务 Handler 说明： • 请求（实线箭头）从左向右依次经过每个中间件，最终到达业务 Handler。 • 响应（虚线箭头）从右向左逆向返回，每个中间件可对响应进行后处理。 • 任意中间件可中断链条（如鉴权失败），直接返回响应，不再调用后续处理器。

1.4 中间件链的构建方式

Go 社区有两种主流的中间件链构建方式：

方式 实现 优点 缺点
嵌套调用 m1(m2(m3(handler))) 标准库原生支持，无需第三方依赖 嵌套层次深时可读性下降
链式构造器 NewChain(m1, m2, m3).Then(handler) 声明式组合，顺序清晰，易于扩展 需要额外封装或引入第三方库

嵌套调用的代码示例：

func main() {
    finalHandler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("Hello, Middleware!"))
    })

    // 嵌套构建中间件链
    handler := LoggingMiddleware(
        AuthMiddleware(
            RateLimitMiddleware(finalHandler),
        ),
    )

    http.Handle("/api", handler)
    log.Fatal(http.ListenAndServe(":8080", nil))
}
关键理解：http.Handler 接口的 ServeHTTP 方法签名是中间件链的“胶水”。每个中间件内部通过调用 next.ServeHTTP(w, r) 将控制权传递给下一个处理器，从而形成完整的请求处理管道。

1.5 中间件的典型应用场景

在实际的 Go 服务开发中，中间件被广泛用于以下横切关注点：

  • 请求日志：记录方法、路径、状态码、耗时。
  • 鉴权与授权：验证 JWT Token、API Key 或 Session。
  • 限流与熔断：基于令牌桶或滑动窗口控制请求速率。
  • 错误恢复：捕获 panic，返回 500 错误，避免服务崩溃。
  • 请求追踪：注入 Trace ID，串联分布式调用链。
  • 跨域处理：设置 CORS 头，处理预检请求。
注意：中间件的执行顺序至关重要。例如，日志中间件通常放在最外层，以便记录所有请求；错误恢复中间件也应放在外层，确保 panic 能被捕获。鉴权中间件应放在业务处理器之前，但可能在日志之后，以便记录鉴权结果。

1.6 本章小结

中间件设计模式为 Go HTTP 服务提供了强大的横切能力。通过 http.Handler 接口与函数式组合，开发者可以构建清晰、可复用的请求处理管道。本章建立的基础概念——中间件链、Handler 接口、嵌套组合——将贯穿后续的 channel 通信与错误聚合模式课程内容。

← 上一章 📖 返回目录 下一章 →