自定义中间件必须通过工厂函数返回符合func(echo.HandlerFunc) echo.HandlerFunc签名的闭包，不可直接接收配置参数；配置结构体需导出字段、避免指针陷阱，并在循环中显式复制变量以防闭包共享。
自定义中间件函数必须返回闭包，不能直接接收配置
Echo 的中间件签名固定为 func(echo.HandlerFunc) echo.HandlerFunc，所以你不能把配置结构体直接塞进中间件函数参数里——那样会破坏类型兼容性。正确做法是：用一个「工厂函数」包裹中间件逻辑，把配置作为工厂的输入，再由工厂返回符合签名的中间件函数。
- 错误写法：
func myMiddleware(cfg MyConfig) echo.HandlerFunc { ... }—— 类型不匹配，e.Use()拒绝接收 - 正确写法：
func myMiddleware(cfg MyConfig) echo.MiddlewareFunc { return func(next echo.HandlerFunc) echo.HandlerFunc { ... } } - 工厂函数名建议带
With后缀（如LoggerWithLevel），便于调用时一眼看出可配
配置结构体要导出字段，且避免指针陷阱
如果你的配置含指针字段（比如 *sync.RWMutex 或 *http.Client），在中间件闭包里直接捕获会导致多个请求共享同一实例，引发并发问题。更安全的做法是：配置结构体只存值类型或不可变对象；需要共享资源（如 logger、client）时，用依赖注入方式传入，而不是靠闭包捕获。
- 推荐：
type RateLimitConfig struct { MaxRequests int `json:"max_requests"` WindowSec int `json:"window_sec"` } - 不推荐：
Client *http.Client字段 —— 除非你明确控制其生命周期并确保线程安全 - 注意：结构体字段必须首字母大写（导出），否则闭包内无法访问
典型示例：带日志前缀和等级的中间件
下面是一个真实可用的工厂式中间件，它接受日志前缀和最小等级，并在每次请求时打印带前缀的路径和耗时：
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
func LoggerWithPrefixAndLevel(prefix string, level log.Lvl) echo.MiddlewareFunc {
return func(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
start := time.Now()
path := c.Request().URL.Path
c.Logger().SetPrefix("[" + prefix + "] ")
c.Logger().SetLevel(level)
c.Logger().Infof("START %s", path)
err := next(c)
c.Logger().Infof("END %s in %v", path, time.Since(start))
return err
}
}
}
使用时：e.Use(LoggerWithPrefixAndLevel("API", log.INFO))。注意这里不是 e.Use(LoggerWithPrefixAndLevel(...)(next)) —— 工厂返回的是中间件函数，e.Use 自动处理调用链。
容易忽略的坑：配置被闭包意外共享
如果在循环中创建多个中间件实例（比如为不同路由组配置不同限流阈值），但用了同一个变量引用，会导致所有中间件实际读取到最后一次迭代的值。根本原因是 Go 闭包捕获的是变量地址，不是值。
- 危险写法：
for _, cfg := range configs { e.Use(RateLimitWithConfig(cfg)) }——cfg在循环中复用 - 修复方式：在循环内显式复制值，例如
for _, cfg := range configs { cfg := cfg; e.Use(RateLimitWithConfig(cfg)) } - 或者改用切片索引访问：
cfg := configs[i]，再传入
