Go语言Web中间件通过包装http.Handler实现通用逻辑，如日志、认证、限流等。1. 基本结构为接收并返回http.Handler的函数；2. 可通过链式调用组合多个中间件，注意执行顺序为后进先出；3. 使用context传递请求数据，建议自定义key类型避免冲突；4. recover中间件可捕获panic防止服务崩溃；5. 中间件应职责单一，避免复杂业务逻辑，提升代码可维护性。
在Go语言构建的Web服务中，中间件（Middleware）是一种非常关键的设计模式，它允许开发者在请求处理流程中插入通用逻辑，比如日志记录、身份验证、跨域处理、请求限流等。合理使用中间件，可以让代码更清晰、职责更分明。下面介绍Golang中Web中间件的实现方式与实用技巧。
中间件的基本原理
Go的HTTP中间件本质上是一个函数，它接收一个http.Handler作为参数，并返回一个新的http.Handler。通过包装原始的处理器，中间件可以在请求到达目标处理函数前后执行额外逻辑。
一个典型的中间件结构如下：
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
log.Printf("%s %s", r.Method, r.URL.Path)
next.ServeHTTP(w, r)
})
}
立即学习“go语言免费学习笔记（深入）”；
使用时，将处理器逐层包装：
handler := loggingMiddleware(http.HandlerFunc(myHandler))
http.Handle("/", handler)
链式中间件的组织方式
当多个中间件需要叠加时，嵌套调用会让代码变得难以阅读。可以封装一个辅助函数来实现链式调用：
func middlewareChain(handlers ...func(http.Handler) http.Handler) func(http.Handler) http.Handler {
return func(final http.Handler) http.Handler {
for i := len(handlers) - 1; i >= 0; i-- {
final = handlers[i](final)
}
return final
}
}
使用方式：
chain := middlewareChain(loggingMiddleware, authMiddleware, corsMiddleware)
http.Handle("/", chain(http.HandlerFunc(myHandler)))
注意中间件的执行顺序：外层函数先执行前置逻辑，然后依次进入下一层，返回时逆序执行后置操作。
上下文传递与请求增强
中间件常用于向请求中注入数据，比如用户身份、请求ID等。Go的context包是实现这一功能的标准方式。
示例：为每个请求生成唯一ID并存入上下文：
func requestIDMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
reqID := generateRequestID() // 生成唯一ID
ctx := context.WithValue(r.Context(), "reqID", reqID)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
在后续处理器中可通过r.Context().Value("reqID")获取该值。建议使用自定义类型作为key，避免键冲突。
错误处理与恢复中间件
Web服务中，未捕获的panic会导致程序崩溃。使用中间件可以统一recover并返回友好错误响应。
func recoverMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
defer func() {
if err := recover(); err != nil {
log.Printf("Panic recovered: %v", err)
http.Error(w, "Internal Server Error", http.StatusInternalServerError)
}
}()
next.ServeHTTP(w, r)
})
}
将此中间件放在链的最外层，可确保所有内部错误都被捕获。
基本上就这些核心技巧。中间件的设计应尽量保持轻量、职责单一，避免在中间件中做复杂业务逻辑。通过组合多个小中间件，可以灵活构建健壮的Web服务处理流程。
