Gin框架全局限流与单路由限流中间件的冲突解决-Golang-PHP中文网

全局限流中间件先执行，路由级限流后执行；执行顺序由注册时机决定，全局限流挂载在所有路由链最外层，形成“全局限流 → 路由级限流 → handler”的洋葱模型。

gin框架全局限流与单路由限流中间件的冲突解决

全局限流中间件和路由级限流同时存在时，谁先执行？

执行顺序由注册时机决定，不是“谁更优先”，而是“谁先挂载谁先跑”。r.Use()注册的全局限流中间件会插入到所有后续注册路由的中间件链最外层（洋葱模型最外圈），而路由级限流（如r.GET("/api/pay", payRateLimit, payHandler)）则被塞进该路由专属 handler 链的内层。结果是：全局限流 → 路由级限流 → handler。

这意味着如果两个限流器都触发拦截，用户看到的是全局限流返回的 429，根本不会走到路由级限流那一步——除非你显式跳过全局的那一个。

全局限流对所有路径生效，包括健康检查、静态资源、登录接口，容易误伤
路由级限流只作用于明确指定的那一行，比如r.POST("/order", orderLimiter, createOrder)
若两者阈值不同（如全局 100rps、单路由 5rps），实际生效的是更严的那个，但错误响应来源不可控

如何让某个路由彻底绕过全局限流？

不能靠“后注册覆盖”，Gin 没有中间件卸载机制。必须在全局限流中间件内部做路径判断，主动跳过。

关键不是“排除”，而是“匹配后直接放行”，避免调用 c.Next() 进入后续链：

func GlobalRateLimit() gin.HandlerFunc {
    limiter := NewLimiter(100, 100) // 全局 100rps
    return func(c *gin.Context) {
        // 明确放行的路径，不参与限流
        if c.Request.URL.Path == "/health" || 
           c.Request.URL.Path == "/login" ||
           strings.HasPrefix(c.Request.URL.Path, "/static/") {
            c.Next()
            return
        }
        if !limiter.Allow() {
            c.AbortWithStatusJSON(http.StatusTooManyRequests, gin.H{"error": "global rate limit exceeded"})
            return
        }
        c.Next()
    }
}