Go Echo框架中除context.Set外如何在中间件与handler间传递对象

方案1：自定义扩展Echo Context（推荐，适配多分类扩展场景） #

Echo原生支持替换默认的Context实现，你可以将需要透传的对象直接定义为自定义Context的成员字段，完全避免Set/Get和魔法字符串、额外类型断言的问题。

实现步骤 #

1. 定义自定义Context结构体，嵌入原生echo.Context，新增需要透传的字段：

type TypeX interface { // 你的TypeX定义，用interface方便扩展不同分类的方法
  H1() any
  H2() any
  B1() any
  B2() any
  B3() any
}

type CustomContext struct {
  echo.Context
  XValue TypeX // 透传的TypeX对象
  BucketHandle func() any // 对应分类的处理方法，可在分类中间件赋值
}

2. 新增全局中间件替换默认Context，放到所有中间件的最前面执行：

func CustomCtxMiddleware(next echo.HandlerFunc) echo.HandlerFunc {
  return func(c echo.Context) error {
    customCtx := &CustomContext{Context: c}
    return next(customCtx)
  }
}

// 注册到Echo实例，用Pre方法保证所有路由都会先执行该中间件
e.Pre(CustomCtxMiddleware)

3. 改造原有加载TypeX的中间件，直接给自定义Context字段赋值：

func mw(next echo.HandlerFunc) echo.HandlerFunc {
  return func(c echo.Context) error {
    cc := c.(*CustomContext)
    // 基于请求参数加载TypeX实例，直接赋值给字段
    cc.XValue = loadTypeXFromRequest(c)
    return next(c)
  }
}

4. 改造分类中间件，直接赋值对应分类的处理方法：

func mwB2(next echo.HandlerFunc) echo.HandlerFunc {
  return func(c echo.Context) error {
    cc := c.(*CustomContext)
    // 直接绑定当前分类对应的方法
    cc.BucketHandle = cc.XValue.B2
    return next(c)
  }
}

5. Handler中直接取字段使用，无需Get和重复类型断言：

func testHandler(c echo.Context) error {
  cc := c.(*CustomContext)
  // 直接调用分类中间件绑定好的方法，不需要额外判断分类
  return c.JSON(http.StatusOK, cc.BucketHandle())
}

优势 #

• 完全类型安全，仅需要在第一次断言为CustomContext，后续所有字段操作都是编译期检查
• 没有魔法字符串key，避免写错key导致的运行时问题
• 扩展灵活，后续新增需要透传的公共参数只需要在CustomContext中加字段即可

方案2：闭包适配器封装（改动最小，适合小型项目） #

如果你不想修改默认Context实现，可以用适配器统一封装Get逻辑，避免每个Handler重复写类型断言代码：

实现步骤 #

1. 定义带TypeX参数的Handler类型和适配器：

// 自定义Handler类型，直接接收TypeX参数
type HandlerWithX func(TypeX, echo.Context) error

// 适配器将自定义Handler转为Echo兼容的HandlerFunc，统一处理Get逻辑
func Adapt(handler HandlerWithX) echo.HandlerFunc {
  return func(c echo.Context) error {
    // 仅在此处做一次Get和类型断言
    xVal := c.Get("key").(TypeX)
    return handler(xVal, c)
  }
}

2. 改造Handler直接接收TypeX参数：

func h1(xVal TypeX, c echo.Context) error {
  return c.JSON(http.StatusOK, xVal.H1())
}

3. 路由注册时用适配器包裹Handler即可：

e.GET("/test", Adapt(h1), mw, mwB2)

优势 #

• 改动量极小，不需要修改原有中间件逻辑
• 避免每个Handler重复写Get和类型断言代码

补充说明 #

如果你不想做任何重构，原生的Set/Get确实是Echo生态下的标准实现方式，性能上没有明显问题，仅存在魔法字符串和运行时断言的风险。

内容的提问来源于stack exchange，提问作者kernel0707