proxy_busy_buffers_size用于控制Nginx已收完但未发完给客户端的数据内存上限，须按proxy_buffers总量的1/4–1/2设置且不低于单块大小，设错会导致后端写阻塞或并发下降。
缓冲区参数不是照抄就行
很多人直接从网上复制一段 proxy_buffer_size、proxy_buffers、proxy_busy_buffers_size 的配置，改个数字就上线。但这些值必须结合后端响应体大小、网络延迟、并发量来定。比如后端返回 2MB 的报表文件，而 proxy_buffers 只设了 4 个 64k 缓冲区，Nginx 就会把响应写入临时磁盘（proxy_temp_path），不仅拖慢速度，还可能因磁盘权限或空间不足引发 502 或 ERR_CONTENT_LENGTH_MISMATCH。
proxy_buffering 开关容易被忽略
默认 proxy_buffering 是 on，意味着 Nginx 会先收完整个响应再发给客户端——这对大文件或流式接口（如 SSE、视频分片）很不友好，会造成明显延迟甚至超时。需要关掉：
- 对流式接口：在对应 location 中加 proxy_buffering off;
- 同时确保 proxy_http_version 1.1; 和 proxy_set_header Connection '';，避免连接被提前关闭
临时目录（proxy_temp_path）权限和位置是硬门槛
Nginx 写临时缓冲内容时，依赖 proxy_temp_path 目录。常见错误包括：
- 该路径未显式声明，Nginx 使用默认值（如 /usr/local/nginx/proxy_temp），但目录不存在或权限不对
- proxy_temp_path 和 proxy_cache_path 不在同一个文件系统，导致 rename 操作失败
- 目录属主不是运行 Nginx 的用户（如 nginx 或 www-data）
验证命令：ls -ld /path/to/proxy_temp；修复建议：chown -R nginx:nginx /path/to/proxy_temp，并在配置中明确写出该路径。
缓冲区与超时参数必须协同调整
光调大缓冲区，不调超时，照样出问题。例如后端响应慢，Nginx 在等数据填满 buffer 时，可能先触发 proxy_read_timeout 而中断连接。
- proxy_read_timeout 应 ≥ 后端最大预期响应时间
- proxy_send_timeout 要匹配客户端网络状况（如弱网上传场景需加大）
- 若启用 proxy_buffering，proxy_buffer_size 至少要能装下响应头（通常 4k–8k 足够）
