Golang多路由中间件使用与实践

中间件是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 框架提供了更清晰的路由分组和中间件注入机制，适合中大型项目。

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

确保关键中间件（如认证）在业务逻辑前完成校验。

基本上就这些。合理组织中间件层级，结合原生或框架能力，可以高效实现多路由下的灵活控制。关键是明确职责分离，避免中间件耦合业务逻辑。