rate.Limiter实例必须按API版本隔离，不可共用，否则v1/v2请求互相挤占配额；应使用map[string]*rate.Limiter按标准化前缀（如"v1"）缓存独立实例，burst值需依各版本吞吐能力差异化设置。
rate.Limiter 实例必须按版本路径隔离
不能所有 API 版本共用一个 rate.Limiter，否则 v1 和 v2 的请求会互相挤占配额。比如你给 v1 设了 10 QPS、v2 设了 5 QPS，若共用 limiter，v2 的请求可能把 v1 的令牌耗尽，或反过来。
正确做法是用 map[string]*rate.Limiter 按路径前缀缓存限流器，例如 /v1/ 和 /v2/ 各持有一个独立实例：
- key 建议标准化为 cleaned path prefix，如
"v1"或"v2"，避免带斜杠或大小写歧义 - 初始化时预热常用版本（如启动时
limiterMap["v1"] = rate.NewLimiter(...)），避免首次请求时加锁创建 - 如果版本号来自 URL query（如
?version=v2），需统一提取逻辑，且注意该字段可能被篡改，不建议作为限流主键
Beego/Gin 中如何在中间件里识别并路由到对应限流器
限流中间件必须在路由匹配后、业务执行前介入，否则无法准确获取版本标识。以 Gin 为例，c.FullPath() 或 c.Request.URL.Path 可提取原始路径；Beego 则用 ctx.Input.URL()。
常见错误是把版本提取逻辑写在 BeforeRouter 阶段（Beego）或用 gin.Params 硬匹配，结果漏掉未注册路由或正则路径。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 推荐方式：用
strings.HasPrefix(path, "/v1/")或正则^/v(1|2)/提取版本标识，再查limiterMap[version] - 若找不到对应 limiter（比如非法版本如
/v99/），应 fallback 到默认限流器或直接拒绝（400 或 404） - 务必检查
AllowN(time.Now(), 1)返回值，false 时立即c.AbortWithStatusJSON(429, ...)并return，否则后续逻辑仍会执行
burst 值要按版本吞吐能力差异化设置
不同 API 版本承载的业务复杂度往往不同：v1 接口轻量、响应快，v2 引入了新聚合逻辑、平均耗时翻倍。若都设 burst=10，v2 在突发流量下更容易排队超时或被拒。
- v1 可设
burst = 2–3 × QPS（如 QPS=20 → burst=40），容忍短时抖动 - v2 建议降低 burst 比例（如 QPS=10 → burst=15），防止慢请求堆积阻塞整个桶
- 绝对不要设
burst=0，否则首次请求必失败（桶初始为空），尤其对冷启动的 v2 接口更致命
多实例部署时版本限流会失效，得换 Redis
golang.org/x/time/rate 是纯内存实现，3 个 Pod 各自维护一套 limiterMap，用户发 30 QPS 就能绕过单机 10 QPS 的 v2 限制——这不是 bug，是设计使然。
若业务要求「全集群 v2 接口严格 ≤10 QPS」，必须引入共享存储：
- 优先选
go-redis/redis_rate，它封装了滑动窗口 + Lua 原子操作，避免 INCR/EXPIRE 竞态 - key 设计示例：
rate:v2:ip:1.2.3.4（按 IP 维度）或rate:v2:uid:abc123（按用户维度） - 注意 Redis 连接池配置：timeout 要小于 HTTP 请求超时，否则限流器自身延迟会拖垮接口 P99
真正难的不是选方案，而是想清楚：你的“版本”限流到底要保什么——是防止单个用户滥用 v2？还是保护 v2 后端服务不被整体打爆？前者用内存 limiter + IP 分桶够用；后者必须上分布式，且 key 得从 IP 升级为 service-level 标识（如 rate:v2:backend）。
