Revel 无内置限流中间件,需手动实现:在 app/init.go 注册 revel.InterceptorFunc,用 golang.org/x/time/rate + sync.Map 按清洗后的真实 IP(优先 X-Forwarded-For 非私有地址)限流,非阻塞调用 TryConsume 并返回 revel.HOLD。

Revel 中没有内置限流中间件,得自己写
Revel 框架本身不提供 RateLimit 或类似 throttle 的开箱即用组件。它的拦截器(Interceptor)机制很灵活,但限流逻辑必须手动实现——不能靠配置开关,也不能直接调用某个框架函数。
常见错误是试图复用其他框架(如 Gin 的 rate.Limiter)中间件写法,结果发现 Revel 的 FilterConfig 和 Result 类型不兼容,c.Abort() 这类方法根本不存在。
- 必须在
app/init.go里注册自定义拦截器,类型为revel.InterceptorFunc - 拦截器函数接收
*revel.Request和*revel.Response,不能直接拿到context.Context,需自行构造或传入 - 拒绝请求时要手动设置
resp.Status = 429并调用resp.Out.Write(),不能返回revel.Result
按 IP 限流要用 golang.org/x/time/rate + sync.Map
Go 标准生态最稳的方案还是 rate.Limiter,但它不能全局共用一个实例——否则所有请求会被当成同一个客户端压垮。
正确做法是:用 sync.Map 缓存每个 IP 对应的 *rate.Limiter,键为客户端真实 IP(注意从 X-Forwarded-For 提取,不是 r.RemoteAddr)。
-
rate.NewLimiter(rate.Every(100 * time.Millisecond), 5)表示“每 100ms 放行 1 个令牌,桶容量 5”,适合突发容忍 - IP 键建议做简单清洗:去掉端口、截断 IPv6 前缀,避免
192.168.1.1:54321和192.168.1.1:39281被当两个 IP - 不建议加过期清理逻辑——Revel 请求生命周期短,
sync.Map本身无 GC 压力;真要清理,可用定时器扫time.Since(lastUsed) > 1h
拦截器里判断超限时,别阻塞主线程
Revel 默认同步处理请求,如果在拦截器里调用 limiter.Wait(ctx),等于把整个请求卡住等令牌,反而放大排队效应。
应该用 limiter.TryConsume(1) 做非阻塞判断——成功就放行,失败就立即拒绝。
- 错误写法:
if err := limiter.Wait(ctx); err != nil { ... }→ 会挂起 goroutine - 正确写法:
if !limiter.TryConsume(1) { resp.Status = 429; resp.Out.Write([]byte("Too Many Requests")); return revel.HOLD } - 注意返回
revel.HOLD终止后续拦截器和 action 执行,不是return就完事
真实 IP 提取容易出错,X-Real-IP 不一定可靠
很多 Revel 部署在 Nginx 后面,但直接读 r.Header.Get("X-Real-IP") 有风险:这个 header 可被客户端伪造,且 Nginx 配置漏写 set_real_ip_from 时会失效。
更稳妥的方式是组合解析 X-Forwarded-For,取最左第一个非私有地址:
- 先检查
r.Header.Get("X-Forwarded-For")是否非空 - 按逗号分割,遍历每个 IP 字符串,用
net.ParseIP()解析并排除私有网段(10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、127.0.0.1等) - 找不到合法 IP 再 fallback 到
r.RemoteAddr(仅限开发或直连场景)
这个逻辑一旦写错,限流就可能对所有请求放行,或者把整个内网流量当成一个 IP 限死——线上出过好几次这类事故。











