burst参数为超出rate限速的请求提供缓冲队列,配合nodelay可瞬时放行(削峰不阻塞),不配则按漏桶节奏匀速释放;需与limit_req_zone定义的zone和rate联用,典型配置如burst=20 nodelay。

Nginx 的 burst 参数用于配合限流模块(如 limit_req)实现“漏桶 + 缓冲队列”机制,允许在限流阈值之外,短暂接纳一定数量的突发请求,避免简单粗暴地全部拒绝。
burst 的作用和基本原理
burst 并不是提高限流上限,而是为超出速率限制的请求提供一个临时排队空间。Nginx 会先按设定速率(如 10r/s)匀速处理请求;当瞬间来大量请求时,超出部分若未满 burst 容量,就暂存进缓冲队列,等待“漏出”;一旦队列已满,后续请求直接返回 503(或按 nodelay 行为立即处理/拒绝)。
burst 必须搭配 rate 和 zone 使用
单独写 burst 没有意义,它必须出现在 limit_req 指令中,并依赖前置定义的共享内存 zone 和基础速率:
- 先在
http块定义限流区域:limit_req_zone $binary_remote_addr zone=perip:10m rate=10r/s; - 再在
server或location中启用并设置缓冲:limit_req zone=perip burst=20 nodelay;
这里 burst=20 表示最多缓存 20 个等待处理的请求。
nodelay 对 burst 行为的影响很关键
burst 的实际效果高度依赖是否加 nodelay:
- 不加
nodelay(默认):Nginx 严格按“漏桶”节奏释放请求。比如rate=10r/s+burst=20,意味着最多积压 2 秒的请求(20 ÷ 10)。新请求进来若队列已满,立刻 503;队列中的请求会按毫秒级延迟依次放行。 - 加
nodelay:Nginx 允许缓冲队列里的请求“立即执行”,但依然受整体速率约束——即:前burst个突发请求可秒过,之后恢复限速。这更接近“令牌桶”的突发响应能力,适合对延迟敏感的接口。
实际配置建议与常见误区
使用 burst 要注意几个实用细节:
- burst 值不宜过大:过大的队列会占用共享内存、增加请求平均延迟,还可能掩盖真实过载问题。一般设为 2–5 倍基础速率较稳妥(如 10r/s → burst=30)。
-
配合 error_page 处理 503:突发超限后返回 503 是默认行为,建议用
error_page 503 = @fallback提供友好提示或降级响应。 - burst 不解决长连接或慢请求问题:它只控制请求接入速率,不干预后端处理时间。如果后端响应慢,队列可能持续积压,需结合超时和上游健康检查。


















