Go语言框架利用装饰器模式包装中间件业务逻辑-Golang-PHP中文网

go中无装饰器语法，中间件链本质是func(http.handler) http.handler函数的嵌套组合，执行呈洋葱模型：外层先处理请求、后处理响应，且必须显式调用next.servehttp(w, r)才能延续链路。

go语言框架利用装饰器模式包装中间件业务逻辑

Go 里没有装饰器语法，别被 Python 思维带偏

Go 语言本身不支持类似 Python 的 @decorator 语法，所谓“装饰器模式”在 Go 中实际是函数式中间件链（middleware chain）的惯用写法——本质是高阶函数套用。强行套用“装饰器”概念，容易误以为能像 Python 那样在方法上加标签，结果卡在语法报错或运行时 panic 上。

常见错误现象：cannot use xxx as type http.Handler、missing return at end of function、中间件顺序错乱导致 next.ServeHTTP 没被调用。

所有中间件必须接收 http.Handler 并返回 http.Handler（或等价的函数签名）
包装逻辑必须显式调用 next.ServeHTTP(w, r)，漏掉就等于中断请求流
中间件执行顺序和注册顺序相反：先注册的后执行（类似洋葱模型外层→内层）

标准中间件函数签名怎么写才不出错

最稳妥的写法是统一用 func(http.Handler) http.Handler 类型，避免混用 func(http.ResponseWriter, *http.Request) 匿名函数导致类型不匹配。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

func LoggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("START %s %s", r.Method, r.URL.Path)
        next.ServeHTTP(w, r) // 必须调用
        log.Printf("END %s %s", r.Method, r.URL.Path)
    })
}

用 http.HandlerFunc 显式转换，确保返回值可被 http.ServeMux 或 chi.Router 接受
不要在中间件里直接写 w.WriteHeader() 后还调用 next.ServeHTTP，否则可能触发 http: multiple response.WriteHeader calls
若需修改响应头或状态码，应在 next.ServeHTTP 之后读取/重写（需用 ResponseWriter 包装器，如 ResponseWriter 装饰）

chi 和 Gin 的中间件注册方式差异很大

chi 使用 r.Use() 注册全局中间件，Gin 用 r.Use() 或 group.Use()，但底层行为不同：chi 的 Use() 是追加到路由树节点，Gin 的 Use() 是累积到引擎或组的 handlers 切片。混淆会导致中间件只对部分路由生效。

chi 中，r.Use(A, B) 等价于每个路由都套 A(B(handler))；但若在子路由上调 sub.Use(C)，则只有该子路由走 C
Gin 中，router.Use(A) 影响全部路由；group.Use(B) 只影响该 group 下路由，且 B 会在 A 之后执行（即 A → B → handler）
切勿把 chi 的中间件直接塞进 Gin 的 Use()——类型不兼容：func(http.Handler) http.Handler 不能当 func(*gin.Context) 用

中间件里想透传业务数据，别用全局变量

常见错误是用包级变量存用户 ID 或请求上下文，结果并发请求互相覆盖。正确做法是通过 context.Context 传递键值对，且 key 类型必须是自定义类型（防止和其他中间件 key 冲突）。

type ctxKey string
const UserIDKey ctxKey = "user_id"

func AuthMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        userID := extractUserID(r.Header.Get("Authorization"))
        ctx := context.WithValue(r.Context(), UserIDKey, userID)
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}