3、第三方路由库（gorilla/mux与chi）中间件机制：Use方法、中间件注册顺序、路由组与中间件作用域

在 Go 生态中，gorilla/mux 与 chi 是两个最流行的第三方路由库。它们不仅提供了强大的路由匹配能力，还内置了灵活的中间件机制。理解它们的 Use() 方法、中间件注册顺序、路由组与作用域规则，是构建可维护中间件链路的基础。

3.1 核心概念：Use() 方法与中间件注册顺序

两个库都通过 Use() 方法将中间件挂载到路由器或路由组上。中间件的执行顺序严格遵循 先注册先执行（FIFO） 的原则，形成一条洋葱链。

3.2 gorilla/mux 中间件注册与作用域

gorilla/mux 通过 Use() 在路由器级别注册中间件，所有路由都会经过这些中间件。若要限定作用域，需使用 Subrouter 创建路由组。

// gorilla/mux 示例：全局中间件与子路由组
r := mux.NewRouter()

// 全局中间件：所有路由都经过
r.Use(loggingMiddleware)
r.Use(recoveryMiddleware)

// 主路由
r.HandleFunc("/api/public", publicHandler)

// 创建子路由组，限定中间件作用域
api := r.PathPrefix("/api/v1").Subrouter()
api.Use(authMiddleware)        // 仅 /api/v1/* 生效
api.Use(rateLimitMiddleware)   // 第二个中间件，在 auth 之后执行
api.HandleFunc("/users", usersHandler)
api.HandleFunc("/orders", ordersHandler)

3.3 chi 中间件注册与路由组

chi 提供了更简洁的路由组 API，通过 Group() 方法显式创建作用域，并支持嵌套组。chi 的中间件机制与 Go 标准库的 context 深度集成，便于在中间件间传递值。

// chi 示例：路由组与中间件作用域
r := chi.NewRouter()

// 全局中间件
r.Use(middleware.Logger)
r.Use(middleware.Recoverer)

// 公开路由
r.Get("/", publicHandler)

// 路由组：/api/v1 下的所有路由
r.Route("/api/v1", func(r chi.Router) {
    r.Use(authMiddleware)        // 仅该组生效
    r.Use(tenantMiddleware)      // 第二个中间件

    r.Get("/users", usersHandler)
    r.Post("/users", createUserHandler)

    // 嵌套路由组：/api/v1/admin
    r.Route("/admin", func(r chi.Router) {
        r.Use(adminOnlyMiddleware)  // 仅 /api/v1/admin/* 生效
        r.Get("/dashboard", dashboardHandler)
    })
})

3.4 中间件作用域与执行顺序对比图

下图展示了 gorilla/mux 与 chi 在路由组嵌套场景下的中间件执行顺序差异。箭头方向表示请求进入时的执行路径。

3.5 中间件注册顺序的实践陷阱

• 顺序依赖：如果中间件 A 依赖中间件 B 设置的上下文值，则 B 必须先注册。例如，认证中间件必须在业务中间件之前注册。
• panic 恢复：recovery 中间件应注册在最外层（最先注册），以确保能捕获所有后续中间件和处理器中的 panic。
• 日志记录：请求日志中间件通常注册在较外层，以便记录完整的请求和响应信息，包括后续中间件可能添加的标签。
• 作用域泄漏：在 gorilla/mux 中，如果忘记使用 Subrouter，中间件会意外应用到所有路由。chi 的 Group() 语法更安全，作用域更明确。

3.6 路由组与中间件作用域的最佳实践