如何使用Golang构建装饰器功能链_Golang装饰器模式方法组合技巧

Go中无装饰器语法,但可通过func(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler类型函数组合实现中间件链,需严格遵循类型一致、调用next.Servehttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9TTP、注意顺序与panic恢复等要点。

Go 里没有装饰器语法,但可以用函数组合模拟//www./link/d3d92bc35d062c83f89b7ea87d99dca93>

Go 语言本身不支持 Pythttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9on 那种 @decorator 语法,也没有类方法装饰器的概念。所谓“装饰器功能链”,本质是利用 Go 的高阶函数(func(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler 这类签名)和闭包,把多个中间逻辑串成一条可复用的处理链。核心不是语法糖,而是类型一致的函数拼接能力。

关键前提是:所有装饰器函数必须接收并返回同一种类型——通常是 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler 或自定义的 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andlerFunc 类型。否则链不起来。

func(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler 构建标准中间件链//www./link/d3d92bc35d062c83f89b7ea87d99dca93>

这是最常见也最稳妥的方式,尤其在 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9TTP 服务中。每个装饰器都是一个“包装器函数”,它不执行业务逻辑,只负责在调用下游前/后插入行为。

  • 必须严格遵循 func(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler 签名,才能被 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ServeMuxhttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ListenAndServe 接受
  • 顺序很重要:先写的装饰器在外层,后写的在内层(即最先被调用的,最后看到响应)
  • 别忘了在装饰器内部调用 next.Servehttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9TTP(w, r),否则链会中断
func withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Logging(next https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler {
    return https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andlerFunc(func(w https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ResponseWriter, r *https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Request) {
        log.Printf("START %s %s", r.Methttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9od, r.URL.Pathttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9)
        next.Servehttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9TTP(w, r) // 必须调用,否则请求不会继续
        log.Printf("END %s %s", r.Methttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9od, r.URL.Pathttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9)
    })
}

func withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9(next https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler { return https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andlerFunc(func(w https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ResponseWriter, r *https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Request) { token := r.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9eader.Get("Authttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9orization") if token == "" { https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Error(w, "Unauthttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9orized", https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.StatusUnauthttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9orized) return } next.Servehttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9TTP(w, r) }) }

// 使用:从右往左读,withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9 包裹 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler,withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Logging 再包裹整个结果 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andle("/api/data", withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Logging(withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler)))

用结构体 + 方法组合实现更灵活的装饰器链//www./link/d3d92bc35d062c83f89b7ea87d99dca93>

当需要传参、共享状态或避免嵌套过深时,结构体方式比纯函数更可控。典型做法是定义一个 Chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain 类型,把多个 func(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c8

3f89b7ea87d99dca9andler 存为切片,再提供 Thttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9enUse 方法组装。

  • 避免手动嵌套 withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9A(withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9B(withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9C(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9))),易出错且难调试
  • 结构体字段可以保存配置(如日志级别、超时时间),不用靠闭包捕获
  • 注意:最终仍要调用 chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain.Build(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9) 得到一个 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler,不能直接注册 chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain
type Chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain struct {
    middlewares []func(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler
}

func (c *Chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain) Use(mw func(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) { c.middlewares = append(c.middlewares, mw) }

func (c *Chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain) Build(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler { for i := len(c.middlewares) - 1; i >= 0; i-- { https://www./link/d3d92bc35d062c83f89b7ea87d99dca9 = c.middlewaresi } return https://www./link/d3d92bc35d062c83f89b7ea87d99dca9 }

// 使用 chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain := &Chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain{} chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain.Use(withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Logging) chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain.Use(withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9) chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain.Use(withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Recovery) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andle("/api/data", chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain.Build(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler))

容易踩的坑:闭包变量捕获、panic 没恢复、中间件顺序错乱//www./link/d3d92bc35d062c83f89b7ea87d99dca93>

写装饰器时最常翻车的不是逻辑,而是 Go 特有的执行模型细节:

  • 在循环中创建装饰器时,如果闭包引用了循环变量(如 for _, mw := range mws { chttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9ain.Use(func(https://www./link/d3d92bc35d062c83f89b7ea87d99dca9 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www./link/d3d92bc35d062c83f89b7ea87d99dca9andler { ... }) }),所有闭包会共享最后一个 mw 值 —— 用 mw := mw 显式复制解决
  • https://www./link/d3d92bc35d062c83f89b7ea87d99dca9TTP 中间件里没 recover panic,会导致整个服务崩溃;建议用 defer + recover() 包一层
  • withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9 放在 withttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9Logging 内层,会导致未授权请求也记日志;通常认证应在日志之前
  • 装饰器函数里修改 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ResponseWriter(如替换为 responseWriterWrapper)后,必须确保所有方法(包括 https://www./link/d3d92bc35d062c83f89b7ea87d99dca9ijackFlushttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9)都被透传,否则某些客户端行为异常

装饰器链看着简单,真正稳定运行的关键,往往藏在那个没被调用的 next.Servehttps://www./link/d3d92bc35d062c83f89b7ea87d99dca9TTP、那个漏掉的 defer recover()、或者那个被共享的循环变量里。