Echo框架中自定义中间件需符合echo.MiddlewareFunc签名,必须调用c.Next();可实现日志、JWT鉴权等逻辑,带配置中间件需用工厂函数返回闭包,JWT中间件须解析token并调用c.Set传递用户信息。

在Echo框架中编写自定义中间件函数,是为了在HTTP请求处理链中插入逻辑,比如日志记录、权限校验或请求体预处理。中间件必须符合echo.MiddlewareFunc签名,即接收echo.Context并返回error,且必须显式调用c.Next()才能继续执行后续处理器。
定义基础中间件函数
第一步:声明一个函数,参数为echo.Context,返回error;第二步:在函数体内调用c.Next(),否则请求流程会在此中断,后续路由处理器永远不会执行;第三步:将该函数作为中间件传入e.Use()或路由组的Use()方法。
这一步操作起来很简单,直接把函数名传进去就行。
添加请求耗时日志中间件
方法一:使用time.Now()记录起始时间,在c.Next()后计算耗时并打印。
方法二:利用defer确保无论是否panic都能记录结束时间——【不加defer可能导致panic时日志丢失】。
方法三:把耗时写入c.Response().Header().Set("X-Response-Time", ...),方便前端调试。
编写带配置参数的中间件
第一步:定义一个配置结构体,例如type LoggerConfig struct { SkipPaths []string };
第二步:编写工厂函数func NewLogger(config LoggerConfig) echo.MiddlewareFunc,返回闭包形式的中间件;
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
第三步:在闭包内判断当前请求路径是否在SkipPaths中,若匹配则跳过日志逻辑,直接调用c.Next();
注意:配置结构体应在中间件注册前完成初始化,否则config.SkipPaths为nil切片会导致panic。
实现JWT身份验证中间件
先从c.Request().Header.Get("Authorization")提取token字符串;
用jwt.Parse解析并校验签名与过期时间;
校验失败时调用c.JSON(401, echo.Map{"error": "invalid token"})并返回echo.ErrUnauthorized;
成功则将用户ID存入c.Set("user_id", claims["user_id"]) ,供后续处理器读取——【忘记调用c.Set会导致下游无法获取用户信息】。










