Gin框架结合Sentinel实现限流降级的中间件配置-Golang-PHP中文网

gin+sentinel限流中间件必须显式调用sentinel.entry和e.exit()，因sentinel-golang是资源粒度轻量库，不自动织入http handler，且gin本身无限流能力；entry与exit须在主goroutine严格配对、判空defer，resourcename须为"default"并传inbound类型，否则系统规则不生效。

gin框架结合sentinel实现限流降级的中间件配置

为什么 Gin + Sentinel 的限流中间件必须显式调用 `sentinel.Entry` 和 `e.Exit()`

因为 sentinel-golang 是资源粒度的轻量库，不自动织入 HTTP handler；Gin 本身也无熔断/限流能力。你写的中间件若只调用 sentinel.Entry 却没配对 e.Exit()，统计上下文就中断，规则永远不生效。

常见错误现象：

配置了 system.InboundQPS 规则但完全不触发限流
请求返回 200 却没走限流逻辑，sentinel.SentinelMiddleware 看似启用实则空转
panic 后 recover 中补 e.Exit() —— 无效，goroutine 已中断，指标已丢失

正确做法：

e.Exit() 必须放在 defer 中，且紧贴 Entry 调用之后（不能在 c.Next() 后或 recover 里）
resourceName 建议统一为 "GET:/api/order" 这类格式，避免字符串散落难维护
必须传 sentinel.WithTrafficType(base.Inbound)，否则系统级规则（如 InboundQPS）不计入统计

`system.LoadRules` 加载后为什么没效果？

system.LoadRules 只是注册规则，不绑定执行上下文。它不监听任何流量，也不自动关联到某个 handler 或资源名。

关键点：

系统级规则（如 InboundQPS、Concurrency）要求 resourceName 必须是 "default"，否则不触发
规则中 MetricType 和实际埋点的 TrafficType 必须匹配：比如用了 system.InboundQPS，埋点就必须带 base.Inbound
必须确保 sentinel.InitDefault() 已成功调用，且无 error；否则后续所有 Entry 都静默失败

示例配置（生效前提）：

if _, err := system.LoadRules([]*system.Rule{{
    MetricType: system.InboundQPS,
    TriggerCount: 200,
    Strategy: system.BBR,
}}); err != nil {
    log.Fatalf("Failed to load system rules: %+v", err)
}