Gin中间件必须是gin.HandlerFunc类型，即func(*gin.Context)签名；需用c.Next()控制流程、c.Set()/c.MustGet()安全传值；Use()注册方式决定作用域，全局或路由级。
中间件函数必须是 gin.HandlerFunc 类型
不是任意函数都能当 Gin 中间件——它必须严格匹配 func(*gin.Context) 签名，否则编译报错或静默失效。Gin 不做类型推断，传错类型（比如漏了 *gin.Context 参数）会导致路由注册失败，但错误提示可能藏在 IDE 或构建日志里，不容易被发现。
-
gin.HandlerFunc是一个类型别名，本质就是函数类型，不是接口或结构体 - 写中间件时别手误写成
func(c gin.Context)（少指针），Go 会认为这是另一个不兼容类型 - 如果想复用普通工具函数，得包一层：
func(c *gin.Context) { yourUtil(c.Request) }
c.Next() 和 c.Abort() 控制执行流
中间件不是“插进去就完事”，它靠 c.Next() 显式调用后续 handler，靠 c.Abort() 阻断后续流程。漏掉 c.Next()，后面的路由处理函数根本不会执行；滥用 c.Abort() 又可能导致响应没写、客户端卡死。
-
c.Next()之后的代码属于“后置逻辑”，比如耗时统计、日志补全，此时响应体可能已写入（取决于下游是否已调用c.JSON()等） -
c.Abort()后不能假设后续代码会被跳过——它只阻止 Gin 调用链，不终止当前函数执行，所以c.Abort()后还写c.JSON()是常见错误 - 认证类中间件通常这样写：
if !valid { c.AbortWithStatusJSON(401, gin.H{"error": "unauthorized"}); return }
全局注册 Use() vs 路由级传参，作用域差异极大
r.Use(m1, m2) 是全局生效（对所有后续注册的路由），而 r.GET("/x", m1, handler) 只影响该条路由。新手常混淆二者，导致中间件意外覆盖或完全不触发。
-
gin.Default()内置了Logger和Recovery，相当于自动调了r.Use(gin.Logger(), gin.Recovery()) - 若用
gin.New()，则什么中间件都没有，连 panic 都会直接崩进程——这点上线前必须确认 - 路由组也支持
group.Use()，适合按模块隔离中间件，比如v1.Use(auth)但v2.Use(rateLimit)
中间件里设值，要用 c.Set() + c.MustGet() 安全取
想把用户 ID、请求 ID 这类上下文数据透传给后续 handler，不能靠全局变量或闭包捕获——并发下会乱。Gin 提供了基于 *gin.Context 的键值存储，但取值不校验类型会 panic。
立即学习“go语言免费学习笔记（深入）”；
-
c.Set("user_id", 123)存，uid, ok := c.Get("user_id")取，ok必须检查，否则类型断言失败直接 panic - 更推荐
uid := c.MustGet("user_id").(int)，它会在 key 不存在或类型不符时主动 abort 并返回 500，避免静默错误 - 键名尽量加前缀防冲突，比如
"auth.user_id"，尤其多人协作或引入第三方中间件时
