4. 中间件概念：什么是中间件、中间件在Web请求生命周期中的位置、洋葱模型原理

4.1 什么是中间件

在 Web 架构中，中间件（Middleware） 是一个可插拔的、位于请求与最终处理函数之间的处理层。它封装了横切关注点（Cross-Cutting Concerns），允许开发者在不修改核心业务逻辑的前提下，对请求/响应进行预处理、后处理或拦截。

4.2 中间件在Web请求生命周期中的位置

一个完整的 Gin 请求生命周期包含以下阶段，中间件位于路由匹配之后、业务处理函数执行之前/之后：

1. HTTP 监听与连接建立 — 服务器接受 TCP 连接
2. 请求解析与路由匹配 — Gin 解析 HTTP 报文，匹配路由树
3. 全局中间件链执行 — 按注册顺序依次进入中间件
4. 路由组中间件链执行 — 若路由属于某个组，则执行组中间件
5. 业务处理函数执行 — 执行最终的路由处理函数
6. 响应回写 — 中间件链反向执行后处理逻辑，最终返回响应

4.3 洋葱模型原理

Gin 的中间件执行机制遵循经典的 洋葱模型（Onion Model）。该模型将中间件链视为多层洋葱皮，请求从外层向内层穿透，响应从内层向外层返回。每一层中间件都可以在调用 c.Next() 之前执行预处理逻辑，在 c.Next() 之后执行后处理逻辑。

4.3.1 洋葱模型执行流程

1. 入向阶段（预处理）：请求依次经过中间件1、中间件2、中间件3，每个中间件在调用 c.Next() 前执行自己的前置逻辑。
2. 核心处理：到达最内层的业务处理函数，执行实际业务逻辑。
3. 出向阶段（后处理）：响应从内层向外层返回，中间件3、中间件2、中间件1依次执行 c.Next() 之后的代码。

4.3.2 洋葱模型的代码体现

以下代码展示了 Gin 中洋葱模型的典型实现：

package main

import (
    "fmt"
    "github.com/gin-gonic/gin"
)

func LoggerMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        // 预处理：请求进入时执行
        fmt.Println("[Logger] 请求进入")

        c.Next() // 将控制权传递给下一个中间件或业务处理函数

        // 后处理：响应返回时执行
        fmt.Println("[Logger] 响应返回")
    }
}

func AuthMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        fmt.Println("[Auth] 鉴权开始")

        // 模拟鉴权失败时中断链式调用
        // c.AbortWithStatus(401)
        // return

        c.Next()

        fmt.Println("[Auth] 鉴权结束")
    }
}

func main() {
    r := gin.New()

    // 注册中间件链：Logger → Auth → 业务处理
    r.Use(LoggerMiddleware(), AuthMiddleware())

    r.GET("/hello", func(c *gin.Context) {
        fmt.Println("[Handler] 执行业务逻辑")
        c.JSON(200, gin.H{"message": "Hello, World!"})
    })

    r.Run(":8080")
}

4.3.3 洋葱模型的执行顺序对比