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

Go 语言本身不支持 Pythttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9on 那种 @decorator 语法,也没有类方法装饰器的概念。所谓“装饰器功能链”,本质是利用 Go 的高阶函数(func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler 这类签名)和闭包,把多个中间逻辑串成一条可复用的处理链。核心不是语法糖,而是类型一致的函数拼接能力。
关键前提是:所有装饰器函数必须接收并返回同一种类型——通常是 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler 或自定义的 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andlerFunc 类型。否则链不起来。
func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler 构建标准中间件链这是最常见也最稳妥的方式,尤其在 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTP 服务中。每个装饰器都是一个“包装器函数”,它不执行业务逻辑,只负责在调用下游前/后插入行为。
- 必须严格遵循
func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler签名,才能被https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ServeMux或https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ListenAndServe接受 - 顺序很重要:先写的装饰器在外层,后写的在内层(即最先被调用的,最后看到响应)
- 别忘了在装饰器内部调用
next.Servehttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTP(w, r),否则链会中断
func withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Logging(next https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler {
return https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andlerFunc(func(w https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ResponseWriter, r *https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Request) {
log.Printf("START %s %s", r.Methttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9od, r.URL.Pathttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9)
next.Servehttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTP(w, r) // 必须调用,否则请求不会继续
log.Printf("END %s %s", r.Methttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9od, r.URL.Pathttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9)
})
}
func withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9(next https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler {
return https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andlerFunc(func(w https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ResponseWriter, r *https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Request) {
token := r.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9eader.Get("Authttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9orization")
if token == "" {
https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Error(w, "Unauthttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9orized", https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.StatusUnauthttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9orized)
return
}
next.Servehttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTP(w, r)
})
}
// 使用:从右往左读,withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9 包裹 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler,withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Logging 再包裹整个结果
https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andle("/api/data", withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Logging(withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler)))
当需要传参、共享状态或避免嵌套过深时,结构体方式比纯函数更可控。典型做法是定义一个 Chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain 类型,把多个 func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler 存为切片,再提供 Thttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9en 或 Use 方法组装。
立即学习“go语言免费学习笔记(深入)”;
- 避免手动嵌套
withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9A(withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9B(withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9C(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9))),易出错且难调试 - 结构体字段可以保存配置(如日志级别、超时时间),不用靠闭包捕获
- 注意:最终仍要调用
chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain.Build(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9)得到一个https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler,不能直接注册chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain
type Chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain struct {
middlewares []func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler
}
func (c *Chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain) Use(mw func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) {
c.middlewares = append(c.middlewares, mw)
}
func (c *Chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain) Build(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler {
for i := len(c.middlewares) - 1; i >= 0; i-- {
https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9 = c.middlewaresi
}
return https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9
}
// 使用
chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain := &Chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain{}
chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain.Use(withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Logging)
chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain.Use(withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9)
chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain.Use(withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Recovery)
https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andle("/api/data", chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain.Build(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler))
写装饰器时最常翻车的不是逻辑,而是 Go 特有的执行模型细节:
- 在循环中创建装饰器时,如果闭包引用了循环变量(如
for _, mw := range mws { chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain.Use(func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler { ... }) }),所有闭包会共享最后一个mw值 —— 用mw := mw显式复制解决 - https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTP 中间件里没 recover panic,会导致整个服务崩溃;建议用
defer+recover()包一层 - 把
withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9放在withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Logging内层,会导致未授权请求也记日志;通常认证应在日志之前 - 装饰器函数里修改
https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ResponseWriter(如替换为responseWriterWrapper)后,必须确保所有方法(包括https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ijack、Flushttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9)都被透传,否则某些客户端行为异常
装饰器链看着简单,真正稳定运行的关键,往往藏在那个没被调用的 next.Servehttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTP、那个漏掉的 defer recover()、或者那个被共享的循环变量里。










