中间件是Golang Web应用中处理请求前后逻辑的核心，通过函数接收并返回http.Handler实现通用功能如日志、认证等。可为不同路由配置独立中间件栈，原生net/http通过链式调用组合，如/public路径使用loggingMiddleware，/admin路径叠加authMiddleware。第三方框架如Gin提供更清晰的路由组机制，支持按需注入中间件，提升可维护性。中间件执行顺序遵循“先进先出”原则，前置逻辑正序执行，后置逻辑逆序返回，需合理安排如认证等关键中间件位置以确保安全。应保持中间件职责单一，避免耦合业务逻辑。
在构建 Golang Web 应用时，中间件是处理请求前后的通用逻辑的核心组件。通过中间件，我们可以统一实现日志记录、身份验证、跨域支持、请求限流等功能。当应用包含多个路由时，如何灵活地为不同路由配置不同的中间件，成为中间件管理的关键。
理解中间件的基本结构
在 Golang 中，一个典型的 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)
})
}
为不同路由配置独立中间件
使用 net/http 原生方式时，可以通过链式调用组合中间件。每个路由组或具体路径可绑定特定的中间件栈。
示例：为特定路由添加认证中间件
func authMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
token := r.Header.Get("Authorization")
if token == "" {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
next.ServeHTTP(w, r)
})
}
// 路由配置
mux := http.NewServeMux()
mux.Handle("/public", loggingMiddleware(http.HandlerFunc(publicHandler)))
mux.Handle("/admin",
loggingMiddleware(
authMiddleware(http.HandlerFunc(adminHandler)),
),
)
使用第三方框架简化中间件管理（以 Gin 为例）
Gin 框架提供了更清晰的路由分组和中间件注入机制，适合中大型项目。
立即学习“go语言免费学习笔记（深入）”；
示例：Gin 中的路由组与中间件
router := gin.Default()
// 公共路由组，仅使用日志
public := router.Group("/public")
{
public.GET("/info", infoHandler)
}
// 认证路由组，叠加认证中间件
authorized := router.Group("/auth", AuthMiddleware(), LoggingMiddleware())
{
authorized.GET("/profile", profileHandler)
authorized.POST("/update", updateHandler)
}
这种方式让中间件按需加载，结构清晰，易于维护。
中间件执行顺序与嵌套控制
中间件的顺序直接影响程序行为。外层中间件先执行前置逻辑，内层后执行；返回时则逆序执行后置操作。
例如：
- 先调用 logging，再调用 auth
- 进入时：log → auth
- 退出时：auth → log
确保关键中间件（如认证）在业务逻辑前完成校验。
基本上就这些。合理组织中间件层级，结合原生或框架能力，可以高效实现多路由下的灵活控制。关键是明确职责分离，避免中间件耦合业务逻辑。
