必须显式配置Skipper函数跳过特定路径,如/health或/static/;仅WithConfig变体中间件支持,需将Skipper赋值给Config结构体的Skipper字段,Static中间件不接受Skipper因其属路由级服务。

要在Echo框架中让中间件跳过特定路径(比如健康检查接口或静态资源),必须显式配置Skipper函数,否则所有请求都会被中间件拦截处理。
定义Skipper函数跳过指定路径
创建一个函数,接收echo.Context参数,返回bool:true表示跳过该中间件,false表示执行。
在函数内部用c.Request().URL.Path获取原始请求路径,然后用strings.HasPrefix或==精确匹配需要跳过的路径。
例如跳过/health和所有以/static/开头的请求:
skipper := func(c echo.Context) bool {<br> path := c.Request().URL.Path<br> return path == "/health" || strings.HasPrefix(path, "/static/")<br>}
将Skipper传入中间件配置
不是所有中间件都支持Skipper,只有带WithConfig变体的中间件才接受。比如middleware.LoggerWithConfig、middleware.RecoverWithConfig、middleware.RequestIDWithConfig等。
以Logger为例,把上一步定义的skipper传入middleware.LoggerConfig的Skipper字段:
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
e.Use(middleware.LoggerWithConfig(middleware.LoggerConfig{<br> Skipper: skipper,<br>}))
【Skipper必须赋值给Config结构体的Skipper字段,不能直接传给e.Use()】
常见中间件的Skipper写法对比
方法一:RequestID中间件跳过/favicon.ico
skipFavicon := func(c echo.Context) bool {<br> return c.Request().URL.Path == "/favicon.ico"<br>}<br>e.Use(middleware.RequestIDWithConfig(middleware.RequestIDConfig{<br> Skipper: skipFavicon,<br>}))
方法二:Recover中间件跳过API文档路径
e.Use(middleware.RecoverWithConfig(middleware.RecoverConfig{<br> Skipper: func(c echo.Context) bool {<br> return strings.HasPrefix(c.Request().URL.Path, "/docs/")<br> },<br>}))
方法三:Static中间件本身不接受Skipper——它通过e.Static()注册,属于路由级静态服务,天然不经过全局中间件链。

















