1. Gin中间件的定义

在Gin框架中，中间件(Middleware)是一个函数，它具有以下特点：

func(c *gin.Context) {
    // 中间件逻辑
}

更准确地说，Gin中间件是一个符合gin.HandlerFunc类型的函数，其签名如下：

type HandlerFunc func(*Context)

2. 中间件的核心特征

访问请求和响应：通过gin.Context参数可以访问请求和操作响应
处理流程控制：
- 调用c.Next()继续执行后续中间件或处理函数
- 调用c.Abort()终止后续中间件执行
执行时机：
- 可以在请求处理前执行(pre-processing)
- 可以在请求处理后执行(post-processing)

3. 中间件的完整生命周期

一个典型的中间件执行流程：

func LoggerMiddleware(c *gin.Context) {
    // 1. 请求处理前的逻辑
    start := time.Now()

    // 2. 调用下一个中间件或路由处理函数
    c.Next()

    // 3. 请求处理后的逻辑
    latency := time.Since(start)
    log.Printf("请求处理耗时: %v", latency)
}

4. 中间件的分类

(1) 全局中间件

router := gin.Default()
router.Use(LoggerMiddleware) // 全局生效

(2) 路由组中间件

authGroup := router.Group("/admin")
authGroup.Use(AuthMiddleware) // 只对该路由组生效

(3) 单个路由中间件

router.GET("/secure", AuthMiddleware, func(c *gin.Context) {
    // 处理逻辑
})

5. 中间件的常见用途

日志记录：记录请求信息、处理时间等
认证鉴权：JWT验证、Session检查等
错误处理：统一错误捕获和处理
限流：控制请求频率
数据预处理：解析通用参数
响应格式化：统一响应格式
CORS处理：跨域资源共享配置

6. 内置中间件示例

Gin自带了一些常用中间件：

// 1. 恢复中间件(Recovery)
router := gin.Default() // 默认包含Logger和Recovery中间件

// 2. 静态文件服务
router.Static("/assets", "./assets")

// 3. 自定义中间件
router.Use(func(c *gin.Context) {
    c.Set("requestId", uuid.New().String())
    c.Next()
})

7. 自定义中间件最佳实践

一个完整的自定义中间件示例：

func RequestIDMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        // 生成唯一请求ID
        requestID := uuid.New().String()

        // 设置到上下文和响应头
        c.Set("Request-ID", requestID)
        c.Writer.Header().Set("X-Request-ID", requestID)

        // 继续处理
        c.Next()

        // 可以在这里添加请求后的处理逻辑
    }
}

// 使用方式
router.Use(RequestIDMiddleware())

8. 中间件链的执行顺序

中间件的执行顺序遵循"洋葱模型"：

请求 -> 中间件1前 -> 中间件2前 -> 处理函数 -> 中间件2后 -> 中间件1后 -> 响应

9. 注意事项

性能影响：中间件会增加处理时间，应避免复杂耗时的操作
错误处理：中间件中应妥善处理错误，避免panic
资源释放：如果有资源分配，确保在适当时候释放
避免阻塞：不要长时间阻塞在中间件中

10. 高级用法：中止中间件链

func AuthMiddleware(c *gin.Context) {
    if !checkAuth(c) {
        // 中止后续中间件执行
        c.Abort()
        c.JSON(http.StatusUnauthorized, gin.H{"error": "未授权"})
        return
    }
    c.Next()
}

总结来说，Gin中间件是一种强大的机制，允许开发者在请求处理流程的不同阶段插入自定义逻辑，实现横切关注点(Cross-cutting concerns)的分离和复用。

Hekyのblog

Gin中间件的定义与详解