Skip to main content

1 / 4概念

Middleware

读完能画出一次请求在 Gin 与 Echo 中间件链中的进出顺序,判断鉴权、恢复和日志为什么没有生效,并把横切逻辑放到正确的层。也能在两者之间迁移同一套请求 ID、超时和错误映射。

1 概念​

1.1 一句话定义​

中间件是包裹 handler 的函数:它在业务处理前执行准备逻辑,在业务处理后执行收尾逻辑,并可提前终止请求。Gin 把它表示为 func(*gin.Context),Echo 表示为 func(next echo.HandlerFunc) echo.HandlerFunc;前者由引擎的索引循环推进,后者靠 next(c) 的嵌套调用推进。

1.2 它解决什么问题​

  • 消除重复:日志、恢复、请求 ID、鉴权、CORS、限流、超时和请求体上限不必写进每个 handler。
  • 固定顺序:横切逻辑的先后决定安全与可观测性,错序时鉴权可能被绕过,日志可能丢请求 ID。
  • 隔离故障:panic 应限制在单个请求内,不能让整个进程退出。
  • 传递取消:请求级 context 要从入口贯穿到数据库和下游调用,客户端断开时及时取消。
  • 统一错误:业务错误要映射成稳定的 HTTP 状态码和错误体,而不是散落在 handler 里。

1.3 不属于本页的内容​

主题去哪
路由匹配、路径参数、绑定与校验Routing and Binding
http.Server、信号、Shutdown、超时Server Lifecycle
goroutine、channel、context 取消语义Goroutines and Channels
认证协议、令牌、权限模型Authentication & Authorization
指标、日志、追踪、熔断Fault Tolerance & Observability

1.4 关键术语​

术语含义容易混淆的点
中间件链按注册顺序排列的 handler 集合不是事件钩子
c.Next()Gin 把剩余 handler 内联执行不是继续执行的唯一方式
c.Abort()Gin 把索引置为终止值,跳过剩余 handler不会停止当前函数
next(c)Echo 调用链中的下一个 handler返回值应继续向上返回
请求 ID标识一次请求的短字符串不是 trace ID
panic 恢复捕获 handler goroutine 的 panic不能捕获其他 goroutine
预检请求浏览器在跨域写请求前发的 OPTIONS不是业务 OPTIONS
限流按时间窗或令牌桶限制请求速率不是并发上限
超时中间件在截止时间到达时返回错误不会停止 handler
请求体上限限制可读取的 body 字节数不是字段级校验