Go中间件是接收并返回http.Handler的函数，常用http.HandlerFunc封装；通过链式调用实现洋葱模型，支持前置/后置逻辑、请求终止及路由集成。
在 Go 的 HTTP 服务中，中间件本质是一个接收 http.Handler 并返回新 http.Handler 的函数。而 http.HandlerFunc 是最轻量、最常用的封装方式——它把普通函数（签名 func(http.ResponseWriter, *http.Request)）转为可注册的处理器，天然适合作为中间件链的“节点”。
用 HandlerFunc 实现基础中间件
中间件函数本身不处理请求，而是包装另一个处理器，在其前后插入逻辑。关键在于：返回一个新的 http.HandlerFunc，并在其内部调用被包装的处理器。
- 定义中间件函数，参数为
http.Handler，返回http.Handler - 在返回的
http.HandlerFunc内，先执行前置逻辑（如日志、鉴权），再调用next.ServeHTTP(w, r) - 注意：必须显式调用
next.ServeHTTP，否则请求会中断
示例：记录请求耗时的中间件
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
next.ServeHTTP(w, r) // 调用下一个处理器
log.Printf("%s %s %v", r.Method, r.URL.Path, time.Since(start))
})
}
链式组合多个 HandlerFunc 中间件
Go 的中间件链是“洋葱模型”：外层中间件的前置逻辑先执行，后置逻辑最后执行。只需将一个中间件的输出（http.Handler）作为下一个中间件的输入即可。
立即学习“go语言免费学习笔记（深入）”；
- 顺序很重要：
loggingMiddleware(authMiddleware(handler))表示先鉴权、再记录日志 - 推荐从右往左读：最右边是原始处理器，每向左包一层，就加一道中间件
- 可封装为辅助函数（如
chain(handler, m1, m2, m3)），但手动嵌套更清晰、无依赖
在 HandlerFunc 内部提前终止请求
中间件常需拦截非法请求（如未登录、权限不足）。此时不能调用 next.ServeHTTP，而应直接写响应并返回。
- 调用
http.Error(w, "xxx", status)或手动设置状态码 +w.Write() - 务必
return，避免后续逻辑执行（尤其是next.ServeHTTP） - 注意：一旦写入响应头（如调用
w.WriteHeader或首次w.Write），就不能再修改状态码或 header
示例：简单身份校验中间件
func authMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
token := r.Header.Get("Authorization")
if token != "valid-token" {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return // 终止链式调用
}
next.ServeHTTP(w, r)
})
}
结合路由（如 gorilla/mux）使用 HandlerFunc 中间件
第三方路由器（如 gorilla/mux）的 Router 本身实现了 http.Handler 接口，因此可直接被中间件包装。
- 先构建路由树（
router := mux.NewRouter()），注册 handler - 最后用中间件包装整个
router：http.ListenAndServe(":8080", loggingMiddleware(authMiddleware(router))) - 也可对子路由单独包装，实现细粒度控制（如仅对
/api/启用鉴权）
基本上就这些。HandlerFunc 封装简洁、无额外抽象，是理解 Go 中间件原理和构建可维护 HTTP 服务的基础方式。
