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

1.1 什么是中间件

中间件（Middleware）是一种在请求处理管道中插入的独立处理单元，用于在请求到达最终处理器之前或之后执行横切关注点（Cross-Cutting Concerns）的逻辑。在 Web 服务中，典型的横切关注点包括：日志记录、身份认证、请求限流、错误恢复、指标采集等。

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

• 可组合性：多个中间件可以按顺序串联成一条处理链，每个中间件只负责单一职责。
• 透明性：中间件对请求方和最终处理器保持透明，不侵入业务逻辑。
• 可复用性：同一中间件可以应用于不同的路由或服务，无需重复实现。

1.2 Go 中函数式中间件模式

Go 语言中实现中间件最自然的方式是使用高阶函数：一个接受 http.Handler 并返回新的 http.Handler 的函数。这种模式被称为"函数式中间件模式"。

其基本签名如下：

// Middleware 是 Go 中间件的标准函数签名
type Middleware func(next 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))
    })
}

多个中间件的串联方式：

// 链式组合中间件
func ChainMiddleware(handler http.Handler, middlewares ...Middleware) http.Handler {
    for i := len(middlewares) - 1; i >= 0; i-- {
        handler = middlewares[i](handler)
    }
    return handler
}

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

chained := ChainMiddleware(
    finalHandler,
    LoggingMiddleware,
    RecoveryMiddleware,
    AuthMiddleware,
)

1.3 Handler 接口与 http.Handler

Go 标准库中的 http.Handler 接口是整个 HTTP 处理体系的核心抽象：

type Handler interface {
    ServeHTTP(ResponseWriter, *Request)
}

这个接口只定义了一个方法 ServeHTTP，任何实现了该接口的类型都可以作为 HTTP 处理器。中间件模式正是建立在这个接口之上——中间件接收一个 Handler，返回一个新的 Handler，从而形成处理链。

下表对比了三种常见的 Handler 实现方式：

1.4 中间件模式的核心优势

函数式中间件模式在 Go 生态中广泛采用，主要得益于以下特性：

• 零依赖：仅依赖标准库 net/http，无需引入第三方框架。
• 类型安全：编译时即可检查中间件签名是否正确。
• 测试友好：每个中间件可以独立单元测试，只需构造 http.Handler 的 mock。
• 组合灵活：通过高阶函数自由组合，支持条件性跳过、短路退出等高级模式。