Revel无内置限流组件,必须通过自定义Filter实现;需注册在全局Filter链中、位于RouterFilter之后ParamsFilter之前,用sync.Map+rate.Limiter单机限流或Redis+Lua脚本集群限流,并正确提取真实IP、标准化key、降级容错。

Revel 没有内置限流组件,所有接口限流必须靠自定义 Filter 实现;直接在 Controller 的 Before() 里写逻辑会漏掉大量请求,且无法提前终止。
限流 Filter 必须注册在全局 Filter 链中
Revel 的限流逻辑只有放在独立的 Filter 函数里、并插入到 RouterFilter 之后、ParamsFilter 之前,才能确保在参数解析和路由匹配完成前就拒绝非法请求。否则,恶意高频请求会一路穿透到 Controller,白白消耗数据库连接和内存。
- 注册位置必须是
app/init.go中的revel.InterceptFunc(RateLimitFilter, revel.BEFORE),不能只对某个 Controller 调用Intercept - Filter 函数末尾必须不调用
fc(c, fcChain),而是直接赋值c.Result并返回,否则请求仍会继续执行 - 若需对特定路径限流(如
/api/send_code),应在 Filter 内部用c.Request.URL.Path匹配,而不是靠多个 Filter 分离
真实 IP 提取必须绕过代理头伪造
部署在 Nginx 后时,c.Request.RemoteAddr 拿到的是 127.0.0.1:42183 这类地址,直接用它做限流 key 等于完全失效。必须从请求头提取真实客户端 IP,但又不能无条件信任 X-Forwarded-For。
- 推荐用
realip.FromHeaders(c.Request.Header, realip.Config{Trusted: []string{"10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"}}),白名单只允许内网代理段设头 - Nginx 配置中必须只由你控制的上游设置
X-Real-IP,禁用$proxy_add_x_forwarded_for—— 它会拼接多层 IP,易被污染 - 提取后建议标准化:IPv4 地址统一不带端口,IPv6 做压缩(如
::1→127.0.0.1),避免同一客户端被算成多个 key
单机限流用 sync.Map + rate.Limiter,别共享实例
golang.org/x/time/rate.Limiter 是最轻量可靠的限流器,但它不是线程安全的全局对象。常见错误是每次请求都 new 一个,或把同一个实例复用于所有 IP —— 前者快速吃内存,后者导致全局限流而非按 IP 独立限流。
- 正确做法:用
sync.Map缓存每个 IP 对应的*rate.Limiter,key 是标准化后的 IP 字符串 - 初始化时传入
rate.NewLimiter(10, 5)表示“每秒最多 10 次,初始桶容量为 5”,注意 burst 容量影响突发容忍度 - 调用
limiter.Allow()判断是否放行,返回false就立即设c.Status = 429和c.Result = revel.RenderError("rate limited")
多实例部署必须用 Redis + Lua 原子脚本
单机 sync.Map 在集群下完全失效。Redis 是唯一可行方案,但不能拆成 INCR + EXPIRE 两步 —— 竞态下可能漏计数或误删 key。
- 必须用 Lua 脚本一次性完成:滑动窗口计数、清理过期时间戳、判断阈值,保证原子性
- key 建议设计为
rl:{ip}:{path}或rl:{user_id}:{path},避免不同接口互相干扰 - 脚本执行失败(如 Redis 连接超时)应降级为放行,而不是阻塞整个请求 —— 限流是优化手段,不是核心业务逻辑
真正容易被忽略的是时间窗口一致性:本地 time.Now() 和 Redis 服务器时间偏差超过几秒,滑动窗口就会错乱;生产环境务必让所有节点 NTP 同步,别依赖各自系统时钟。











