3. HTTP 协议与中间件模式：请求/响应生命周期与链式设计

在构建权限审计网关时，理解 HTTP 请求/响应的完整生命周期是设计中间件链的基础。Go 标准库 net/http 提供了简洁的接口，而中间件模式则允许我们在不修改核心处理逻辑的前提下，横切地注入认证、授权、审计等能力。本章将深入剖析这两者的结合点。

3.1 HTTP 请求/响应生命周期

一个典型的 HTTP 请求从客户端发出到服务端返回响应，经历以下核心阶段。网关作为反向代理，处于客户端与上游服务之间，拥有对请求和响应的完全控制权。

3.2 Go 标准库 net/http 核心接口

net/http 包定义了网关开发中最核心的两个接口：http.Handler 和 http.HandlerFunc。所有中间件和最终处理函数都遵循相同的签名。

3.3 中间件链模式设计

中间件链模式的核心思想是将多个处理阶段串联起来，每个阶段决定是否将请求传递给下一个阶段，或者直接终止并返回响应。在权限审计网关中，典型的中间件链顺序如下：

1. 请求日志/追踪 — 记录请求 ID、来源 IP、路径
2. 限流 — 基于令牌桶或滑动窗口算法
3. 认证 — 验证 JWT / API Key / OAuth2 Token
4. 授权 — 检查 RBAC / ABAC 权限策略
5. 审计 — 记录请求和响应摘要到审计日志
6. 代理转发 — 将请求转发到上游服务

以下是一个标准的 Go 中间件链实现示例：

// 中间件类型定义
type Middleware func(http.Handler) http.Handler

// 构建中间件链：按顺序包装
func Chain(handler http.Handler, middlewares ...Middleware) http.Handler {
    for i := len(middlewares) - 1; i >= 0; i-- {
        handler = middlewares[i](handler)
    }
    return handler
}

// 认证中间件示例
func AuthMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        token := r.Header.Get("Authorization")
        if token == "" {
            http.Error(w, "Unauthorized", http.StatusUnauthorized)
            return
        }
        // 验证 token 逻辑...
        // 将用户信息注入上下文
        ctx := context.WithValue(r.Context(), "user", "admin")
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

// 审计中间件示例
func AuditMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 请求前记录
        log.Printf("[AUDIT] %s %s", r.Method, r.URL.Path)
        // 包装 ResponseWriter 以捕获状态码
        lrw := &loggingResponseWriter{ResponseWriter: w, statusCode: http.StatusOK}
        next.ServeHTTP(lrw, r)
        // 请求后记录
        log.Printf("[AUDIT] Status: %d", lrw.statusCode)
    })
}

// 使用链
func main() {
    finalHandler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("Hello, authenticated user!"))
    })
    handlerChain := Chain(finalHandler, AuthMiddleware, AuditMiddleware)
    http.Handle("/api", handlerChain)
    http.ListenAndServe(":8080", nil)
}

3.4 中间件链的上下文传递

在权限审计网关中，中间件之间需要共享数据（如用户身份、权限列表、请求追踪 ID）。Go 1.7+ 引入的 context.Context 是标准做法。每个中间件可以将处理结果注入到请求的上下文中，后续中间件或业务处理器通过 r.Context() 读取。

3.5 中间件链的终止与错误处理

中间件链的一个重要特性是“短路”能力。当认证失败、权限不足或触发限流时，中间件可以直接写入响应并返回，不再调用 next.ServeHTTP。这要求每个中间件在决定终止时，必须自行处理 ResponseWriter 的状态码和 Body。

// 限流中间件示例：直接终止请求
func RateLimitMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        if !rateLimiter.Allow() {
            w.Header().Set("Content-Type", "application/json")
            w.WriteHeader(http.StatusTooManyRequests)
            w.Write([]byte(`{"error":"rate limit exceeded"}`))
            return // 不调用 next，链终止
        }
        next.ServeHTTP(w, r)
    })
}