Revel 框架需手写限流中间件,基于 rate.Limiter 按用户 ID 或 IP 维护独立实例,用 sync.Map 缓存;须在鉴权后、业务前执行 AllowN 判断,并通过配置控制开关与阈值。

Revel 框架本身不内置限流中间件,但可以无缝集成 golang.org/x/time/rate 实现精确、轻量、线程安全的接口级限频,关键在于正确绑定限流器生命周期和提取请求标识。
为什么不用 revel-contrib/ratelimit 或第三方插件
这些插件多数封装了 rate.Limiter,但存在两个硬伤:一是默认按 path 全局共享一个限流器(所有用户共用),二是中间件执行顺序不可控,容易在 JWT 解析前就触发限流,导致 user_id 提取失败。直接手写中间件更可控,也避免引入隐式 context 传递 bug。
在 Revel 中按用户 ID 或 IP 创建独立限流器
必须为每个维度(如 "user:123" 或 "ip:192.168.1.1")维护独立的 *rate.Limiter 实例,不能复用同一个对象。推荐用 sync.Map 缓存,键为标识字符串,值为限流器指针:
var limiterCache sync.Map // key: string, value: *rate.Limiter
<p>func getLimiter(key string, qps int, burst int) <em>rate.Limiter {
if lim, ok := limiterCache.Load(key); ok {
return lim.(</em>rate.Limiter)
}
lim := rate.NewLimiter(rate.Limit(qps), burst)
limiterCache.Store(key, lim)
return lim
}</p>
- burst 建议设为
qps * 2~qps * 3,防偶发抖动误拒 - 不主动清理过期项?没问题——
rate.Limiter本身无状态,内存占用极低;若需控制规模,可加定时 goroutine 扫描sync.Map+time.Since()判断最后访问时间 - 别用
map[string]*rate.Limiter配sync.RWMutex,sync.Map在高并发读多写少场景下性能更好
Revel interceptor 中正确调用 AllowN 并提前终止
限流逻辑必须放在 BEFORE interceptor,且排在鉴权(如 JWT 解析)之后、业务 action 之前。示例中假设已从 token 解析出 userID,或从 X-Forwarded-For 提取出真实 IP:
func RateLimitFilter(c *revel.Controller, fc []revel.Filter) {
var key string
if uid := c.Params.Get("userID"); uid != "" {
key = "user:" + uid
} else {
key = "ip:" + getClientIP(c.Request)
}
<pre class="brush:php;toolbar:false;">limiter := getLimiter(key, 10, 20) // 10 QPS, burst=20
if !limiter.AllowN(time.Now(), 1) {
c.Response.Status = "429 Too Many Requests"
c.Result = c.RenderError("too many requests")
return
}
revel.FILTER_CONTINUE(c, fc)
}
-
AllowN是非阻塞判断,返回false就必须立即终止,不能继续c.Render或调c.RenderJSON - 不要用
WaitN——它会挂起请求,违背 REST 响应时效性原则 - 真实 IP 提取必须校验可信代理链,比如只信任
X-Real-IP(由 Nginx 设置),而非无条件读X-Forwarded-For
Revel 路由级开关与配置分离
不是所有接口都需要限流。应在 app/init.go 的 init() 函数里注册 interceptor,并通过配置文件(如 conf/app.conf)控制开关和参数:
rate.limit.enabled = true rate.limit.user.qps = 10 rate.limit.ip.qps = 5 rate.limit.burst = 30
然后在 interceptor 中读取:revel.Config.IntDefault("rate.limit.user.qps", 10)。这样上线后可通过配置热更新阈值,无需重启服务。
最容易被忽略的是:Revel 的 Params 不自动解析 JWT payload,userID 必须由你自己的鉴权 interceptor 提前注入到 c.Params;否则这里拿到的永远是空字符串,退化成纯 IP 限流——而攻击者可轻易伪造 IP(尤其在有 CDN 场景下)。











