proxy_busy_buffers_size应设为proxy_buffers总量的1/4至1/2且不低于单块大小,以平滑“已收未发”数据发送节奏、减少ttfb毛刺;中小响应按比例配置即可,大文件或流式响应宜关闭proxy_buffering。

调优 proxy_busy_buffers_size 降低客户端接收时延毛刺,核心是让 Nginx 在“已收后端数据、但尚未发完给客户端”这一中间状态中,保持足够缓冲空间来平滑发送节奏,避免因忙区填满而频繁暂停读上游、卡顿发包,从而减少首字节延迟(TTFB)和后续分块发送的抖动。
理解毛刺来源:忙区饱和触发的链路停顿
客户端接收毛刺常表现为:响应开头快、中间卡顿、末尾又加速;或压测中 P95/P99 延迟远高于均值。这往往不是网络问题,而是 Nginx 缓冲调度失衡所致:
- 设得太小(如默认 8k),几 KB 就触发“忙区满”,Nginx 立即暂停从后端读取 → 后端可能短暂停写,TCP 窗口收缩,等 Nginx 清空部分 buffer 后再唤醒 → 引入毫秒级到数百毫秒不等的间歇性停顿
- 客户端读取慢(如弱网、移动端)、或服务端响应体大(如 SSR HTML、报表导出),加剧 busy 区积压,放大毛刺频率
- 若 busy 值接近甚至等于
proxy_buffers总量,Nginx 无空闲 buffer 接收新数据,整条流水线卡死,毛刺直接升级为超时或 502
按比例设定:总量的 1/4 至 1/2 是稳定区间
该值不是独立内存池,而是从 proxy_buffers 总量中划出的“活跃发送配额”。必须按比例协同设置,才能兼顾吞吐与稳定性:
-
proxy_buffers 8 128k;(总量 1MB)→proxy_busy_buffers_size 256k;或512k;(取 1/4~1/2,且 ≥ 单块 128k) -
proxy_buffers 16 256k;(总量 4MB)→proxy_busy_buffers_size 1m;或2m; - 单块 buffer 为 256k 时,busy 值低于 256k 会刚填满一块就停,epoll 频繁唤醒,反而增加系统开销和毛刺
区分响应类型,避免一刀切放大抖动
不同业务对“平滑发送”的需求不同,统一调大可能适得其反:
-
中小响应(API JSON、SSR 首屏 HTML,通常 ≤200KB):用
proxy_buffers 8 128k;+proxy_busy_buffers_size 256k;即可覆盖完整响应,减少中途停顿 -
大文件下载(≥10MB):建议直接
proxy_buffering off;,Nginx 边收边发,TTFB 最低,毛刺基本消失;此时proxy_busy_buffers_size完全不生效,无需配置 - 流式响应(SSE、日志 tail):同样应关 buffering,靠操作系统 TCP 缓冲和 event loop 自然平滑,强行开 buffering 反而因 busy 区限制造成断流
验证是否真正消除毛刺
reload 后不能只看服务是否运行,要观察真实链路信号:
- 用
curl -sI http://your-api/检查响应头:若有准确Content-Length且无Transfer-Encoding: chunked,说明缓冲完整工作,未被截断 - 对比压测前后
$request_time的 P95 分位:毛刺收敛意味着长尾延迟明显下降 - 检查 Nginx error log 是否仍有
upstream timed out或client intended to send too large body类报错,这些是 busy 区反复饱和的直接证据











