Nginx代理大响应性能瓶颈在于缓冲区与后端响应不匹配，需分层调控：proxy_buffer_size控响应头（建议8k/16k），proxy_buffers与proxy_busy_buffers_size协同控响应体，proxy_buffering按场景开关，并同步调优超时、临时文件及连接复用。
代理大响应时的性能瓶颈，核心在于 Nginx 缓冲区与后端响应特征不匹配——不是简单调大所有值，而是分层控制请求头、响应头、响应体三类缓冲，并让它们协同工作。
先稳住响应头：防 502 报错
proxy_buffer_size 只管响应头（状态行 + 所有 header + CRLF），默认 4k 极易被长 JWT、多 Set-Cookie 或网关透传 header 打爆，直接报 “upstream sent too big header”。
- 实测抓包看最大响应头长度（含换行符），比如是 5212 字节，就设为 proxy_buffer_size 8k
- 建议起步值为 8k 或 16k，放在 location 块中、proxy_pass 之前
- 若用 HTTP/2，同步检查 http2_max_field_size（默认也是 4k），否则 HPACK 解码失败也会触发 502
再配响应体缓冲：避免阻塞和落盘
proxy_buffers 和 proxy_busy_buffers_size 是一对必须协同设置的参数，各自作用不同：
- proxy_buffers 8 128k：共分配 1MB 内存，用于暂存响应体；SSR 页面建议用此配置，大 JSON 导出可升至 16 256k（总 4MB）
- proxy_busy_buffers_size 必须 ≤ proxy_buffers 总量的 1/2，且 ≥ 单块大小；例如上例中推荐设为 256k 或 512k
- 设太小（如仍用默认 8k）→ 后端刚写几 KB 就阻塞；设太大（如超总量 2/3）→ 空闲缓冲不足，多连接抢不到资源
按场景决定是否开启缓冲
proxy_buffering 不是默认开就万事大吉，要根据响应特性动态选择：
- 必须关闭：大文件下载（≥10MB）、SSE、日志流、gRPC-Web 等流式响应——用 proxy_buffering off 实现边收边传
- 建议开启：常规 HTML/API、需改写 Header、做 gzip 或缓存校验的场景；此时务必显式声明 proxy_buffering on，并配合 proxy_buffers 调优
- 注意：proxy_buffering off 时，proxy_buffers 和 proxy_busy_buffers_size 完全不生效
配套调优不能少
缓冲区只是链路一环，还需同步调整超时与临时文件行为：
- 延长等待时间：proxy_read_timeout 300（报表导出、大文件回源等长耗时场景）
- 控制磁盘落盘：proxy_max_temp_file_size 1024m（允许单个临时文件最大 1GB），并确保 proxy_temp_path 挂载在 SSD 上
- 启用连接复用：proxy_http_version 1.1 + proxy_set_header Connection ""，减少握手开销
