3、链式中间件模式：洋葱模型、中间件嵌套、next.ServeHTTP调用链、请求生命周期

链式中间件模式是 Go Web 框架（如 Gin、Echo、Chi）的核心架构范式。它通过将多个中间件函数嵌套组合，形成一个可递归调用的处理链，使得请求在进入最终业务处理器之前，能够依次经过日志记录、身份认证、请求限流、链路追踪等横切关注点。本章深入剖析洋葱模型、中间件嵌套机制、next.ServeHTTP 调用链以及请求的完整生命周期。

3.1 洋葱模型：请求与响应的双层穿透

洋葱模型（Onion Model）是链式中间件最直观的抽象。请求从最外层中间件进入，逐层向内穿透，直到抵达核心的业务处理器；响应则从核心向外逐层返回，每一层在返回前后都可以执行额外的逻辑。

3.2 中间件嵌套与 next.ServeHTTP 调用链

在 Go 中，中间件通常定义为 func(next http.Handler) http.Handler 的形式。嵌套通过显式调用 next.ServeHTTP(w, r) 实现：

// 中间件 A：日志记录
func LoggerMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("[A] 请求进入: %s %s", r.Method, r.URL.Path)
        next.ServeHTTP(w, r)  // 调用下一个中间件
        log.Printf("[A] 响应离开: %s %s", r.Method, r.URL.Path)
    })
}

// 中间件 B：身份认证
func AuthMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        if r.Header.Get("Authorization") == "" {
            http.Error(w, "Unauthorized", http.StatusUnauthorized)
            return  // 中断调用链
        }
        log.Printf("[B] 认证通过")
        next.ServeHTTP(w, r)  // 调用下一个中间件
        log.Printf("[B] 认证后处理")
    })
}

// 中间件 C：请求限流
func RateLimitMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        if !rateLimiter.Allow() {
            http.Error(w, "Too Many Requests", http.StatusTooManyRequests)
            return
        }
        log.Printf("[C] 限流通过")
        next.ServeHTTP(w, r)
    })
}

嵌套组合时，调用链的构建顺序决定了执行顺序：

// 构建链式中间件
finalHandler := LoggerMiddleware(
    AuthMiddleware(
        RateLimitMiddleware(
            http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
                w.Write([]byte("Hello, World!"))
            }),
        ),
    ),
)

3.3 调用链执行顺序与生命周期阶段

一个完整的请求生命周期可以划分为 6 个阶段，每个阶段对应中间件调用链中的特定位置：

3.4 错误聚合与中断传播

在链式中间件中，错误处理遵循“就近捕获、向上传播”的原则：

• 中断传播： 中间件可以通过不调用 next 并直接写入错误响应来中断调用链。后续中间件不会执行。
• 错误聚合： 外层中间件可以捕获内层中间件或业务处理器中发生的 panic，统一记录并返回 500 错误。
• 上下文传递： 使用 context.Context 在中间件之间传递请求范围内的错误信息、追踪 ID 和超时控制。

// 错误聚合中间件示例
func RecoveryMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if rec := recover(); rec != nil {
                log.Printf("[Recovery] 捕获 panic: %v", rec)
                http.Error(w, "Internal Server Error", http.StatusInternalServerError)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

// 上下文传递错误信息
func ErrorContextMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        ctx := context.WithValue(r.Context(), "requestID", uuid.New().String())
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

3.5 链式中间件的性能考量

3.6 最佳实践总结

• 洋葱模型 是链式中间件的核心抽象，请求入栈、响应出栈，形成对称的生命周期。
• next.ServeHTTP 是调用链的递进点，不调用则中断链。
• 前置逻辑 用于请求预处理、认证、校验；后置逻辑 用于响应处理、清理、统计。
• 错误聚合 通过 Recovery 中间件在最外层统一捕获 panic，避免服务崩溃。
• 上下文传递 使用 context.Context 在中间件间传递请求 ID、超时、错误信息等。
• 性能优化 应减少中间件层数，合并功能，避免在中间件中执行耗时操作。