nodelay 参数使请求即时通过或立即拒绝,消除令牌桶排队延迟,需与burst联用以控制突发容忍度,不提升实际容量。

使用 limit_req 的 nodelay 参数,本质是绕过令牌桶的等待机制,让请求“即时通过”或“立即拒绝”,从而在保障限流前提下消除排队延迟,适合对端到端延迟敏感的 API 网关场景。
理解 nodelay 的真实行为
nodelay 并不取消限流,而是禁用请求在令牌桶中排队等待。当桶中无可用令牌时,请求直接返回 503(或自定义状态码);当有令牌,立刻放行——没有毫秒级排队延迟。
- 对比默认行为:无
nodelay时,请求可能被挂起几十毫秒等下一个令牌,造成不可控延迟抖动 -
nodelay下,P99 延迟更稳定,但突发流量会更快触发拒绝,需配合前端重试或降级策略 - 典型配置:
limit_req zone=api burst=10 nodelay;表示允许最多 10 个请求瞬时透支,超出即拒,不排队
与 burst 配合控制突发容忍度
nodelay 必须和 burst 同时使用才有意义。burst 定义“可瞬时透支的请求数”,nodelay 决定这 burst 个请求是否排队。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw,涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 例如:
limit_req zone=api rate=100r/s burst=20 nodelay;→ 每秒最多处理 100 请求,但允许最多 20 个请求在瞬间“插队”通过(不等令牌),之后第 21 个就立刻 503 - 若只写
burst=20不加nodelay,这 20 个请求会在 200ms 内匀速释放(因 100r/s ≈ 10ms/个),引入延迟 - burst 值不宜过大,否则削弱限流效果;建议按业务可接受的瞬时峰值设定,如压测得出的 2~3 倍均值
避免误用:nodelay 不等于“不限流”
常见误解是认为加了 nodelay 就能扛住所有突发。实际上它只是改变了拒绝方式,而非提升容量。
- 后端服务仍可能因瞬时高并发被打垮,因此需结合 upstream 的负载均衡、健康检查与熔断(如 nginx plus 的
slow_start或外部 service mesh 控制) - 建议搭配日志记录被拒绝请求:
limit_req_status 503;+ 自定义 log_format 记录 $limit 和 $limit_rate 变量,便于监控突增源头 - 对关键接口,可为不同 client_id 或 app_id 设置独立 zone,避免单个调用方拖垮全局,再分别配 nodelay
验证与调优建议
上线前必须实测,观察真实延迟分布和拒绝率是否符合预期。
- 用
wrk -t4 -c100 -d30s --latency http://gateway/api对比开启/关闭 nodelay 的 P95/P99 延迟变化 - 监控
limit_req_rejected计数器(需启用 stub_status 或 openresty 的 prometheus 模块),若拒绝率持续 >5%,说明 burst 偏小或基础 rate 过低 - 灰度发布时,先对非核心路径启用,确认日志、指标、告警链路正常后再推广
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










