本文介绍如何在 go 原生 net/http 中为所有请求或特定路径（如 /authapi/）统一执行预处理逻辑，无需第三方路由库，通过 http handler 链式封装实现轻量、可控的中间件机制。
本文介绍如何在 go 原生 net/http 中为所有请求或特定路径（如 /authapi/）统一执行预处理逻辑，无需第三方路由库，通过 http handler 链式封装实现轻量、可控的中间件机制。
在 Go 的标准 HTTP 服务中，http.ServeMux 本身不支持“中间件”概念，但其设计高度组合化——每个 http.Handler 都可被包装为另一个 http.Handler。这使得我们能以函数式方式注入预处理逻辑：在请求真正分发给具体路由处理器之前，先执行认证、日志、CORS 设置或权限校验等通用操作。
✅ 全局预处理：包装整个 ServeMux
最简洁的方式是将 ServeMux 封装进一个匿名 http.HandlerFunc，在调用 mux.ServeHTTP() 前插入自定义逻辑：
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/API/user", test)
mux.HandleFunc("/authAPI/admin", auth)
// 全局前置处理：每次请求都执行
http.ListenAndServe(":8080", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// ? 所有请求均在此处统一处理
log.Printf("? Incoming request: %s %s", r.Method, r.URL.Path)
// 可在此添加：身份验证解析、请求体限流、上下文注入等
ctx := r.Context()
// 例如：r = r.WithContext(context.WithValue(ctx, "traceID", generateTraceID()))
mux.ServeHTTP(w, r) // 继续路由分发
}))
}✅ 路径前缀级预处理：按需拦截 /authAPI/
若仅需对 /authAPI/ 下的所有路径（如 /authAPI/admin、/authAPI/users）执行鉴权，可在包装逻辑中增加路径匹配判断：
func authMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if strings.HasPrefix(r.URL.Path, "/authAPI/") {
// ? 仅对 /authAPI/ 路径执行认证检查
if !isValidAuth(r.Header.Get("Authorization")) {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
log.Printf("✅ Auth passed for %s", r.URL.Path)
}
next.ServeHTTP(w, r) // 放行至下游处理器（如 mux）
})
}
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/API/user", test)
mux.HandleFunc("/authAPI/admin", auth)
mux.HandleFunc("/authAPI/users", listUsers)
// 应用路径感知中间件
http.ListenAndServe(":8080", authMiddleware(mux))
}? 提示：authMiddleware 是一个典型的中间件构造函数（middleware factory），它接收 http.Handler 并返回新的 http.Handler，符合 Go 生态惯用模式，易于复用与组合（如叠加 loggingMiddleware(authMiddleware(mux))）。
⚠️ 注意事项与最佳实践
- 避免阻塞主流程：预处理逻辑应轻量；耗时操作（如 DB 查询）建议异步或使用上下文超时控制。
- 响应头/状态码冲突：若中间件已写入响应（如调用 http.Error 或 w.WriteHeader），后续 handler 不得再写响应，否则 panic。
- r.URL.Path 安全性：注意路径规范化（如 //authAPI/ 或 ../），生产环境建议用 r.URL.EscapedPath() 或结合 path.Clean() 校验。
- 上下文传递：优先使用 r = r.WithContext(...) 注入数据，而非全局变量，确保并发安全与作用域清晰。
- 错误处理统一化：可封装 errorHandler 中间件，捕获 handler panic 并返回 500，提升健壮性。
通过这种基于 http.Handler 组合的设计，你无需引入 Gin、Echo 等框架，即可构建清晰、可测试、符合 Go 哲学的 HTTP 中间件链——简单、直接，且完全掌控底层行为。
