nginx“缓冲区溢出”是代理层因响应过大、客户端慢或超时不合理导致的连接中断，表现为502/504等错误；需调优proxy_buffer_size、proxy_buffers等参数，而非禁用缓冲。
Nginx 中所谓“缓冲区溢出”，不是程序级内存漏洞，而是代理过程中因响应过大、客户端读取慢或超时设置不合理，导致缓冲机制主动中断连接，表现为 502/504 错误、upstream sent too big header 或 client intended to send too large body 等日志提示。处理核心是合理调优缓冲参数与超时值，而非禁用缓冲。
明确缓冲作用对象和关键参数
Nginx 的 proxy 缓冲分两类：
-
响应头缓冲：由
proxy_buffer_size控制，只存响应头（含 Set-Cookie、自定义 Header 等），必须能容纳完整 header。默认 4k，大 cookie 或多 header 场景下容易不足。 -
响应体缓冲：由
proxy_buffers控制，用于暂存后端返回的响应内容（如 JSON、HTML、文件流）。默认8 4k（共 32KB），大报表、导出文件或长轮询接口需增大。
相关配套参数不能孤立设置：
-
proxy_busy_buffers_size应 ≤ 总 buffer 容量，且 ≥proxy_buffer_size，它决定“边收边发”阶段最多可推送多少数据。 -
proxy_max_temp_file_size控制超出内存缓冲后写入磁盘的单个临时文件上限，默认 1G；设为 0 表示禁用磁盘缓存（不推荐，可能直接失败）。
针对常见场景调整缓冲策略
后端返回大响应（如导出 CSV/Excel、长 JSON）
- 增大响应体缓冲：
proxy_buffers 16 16k;（256KB 内存缓冲） - 加大响应头缓冲：
proxy_buffer_size 64k;（应对带大量 Cookie 或自定义字段的响应） - 允许磁盘落盘：
proxy_max_temp_file_size 2048m;（2GB，确保空间充足）
大文件上传（POST 含大 body）
- 解除请求体限制：
client_max_body_size 2G;（写在 location 块内更安全） - 提高后端读取等待时间：
proxy_read_timeout 3600;（避免上传中途被 Nginx 主动断连） - 若后端支持流式反馈，可关缓冲：
proxy_buffering off;（此时proxy_buffers等参数失效，响应直通）
客户端网络差或移动端访问频繁
- 增加发送超时：
proxy_send_timeout 120;（两次向客户端写数据的间隔） - 保持缓冲开启：
proxy_buffering on;（便于控制、重试和错误处理，关闭后易受弱网影响）
同步检查系统与路径配置
- 确认
client_body_temp_path指向的磁盘分区有足够空间且 I/O 稳定（Nginx 默认将大请求体暂存于此） - 检查内核参数：
net.core.somaxconn和net.ipv4.tcp_max_syn_backlog建议 ≥ 65535，避免连接队列溢出 - 若启用 HTTPS，TLS 握手耗时也会影响整体窗口，可启用 session reuse 减少开销
不复杂但容易忽略
