核心是按响应特征分层调参：proxy_buffering on用于常规API，off用于SSE/LLM流式场景；proxy_buffer_size需设16k防502；proxy_buffers与proxy_busy_buffers_size应协同配置以匹配响应体量，避免临时文件过多或内存溢出。
在 Location 块中配置代理缓冲区，核心不是“快速缓存”，而是合理分配内存缓冲、控制响应流转节奏，防止因缓冲不足导致阻塞（如 502、超时、临时文件写入过多）。关键在于按响应特征分层调参，而不是盲目增大所有值。
先决定是否开启 proxy_buffering
这是所有缓冲行为的前提：
- proxy_buffering on：适合常规 API、HTML 页面、静态资源等——Nginx 边收边传，但需足够缓冲空间承接后端响应头+部分响应体；可缓解客户端慢速读取对后端连接的占用
-
proxy_buffering off：必须用于 SSE、LLM 流式响应、大文件下载等持续输出场景——数据收到即发，不暂存，避免积压和超时；此时
proxy_buffers和proxy_busy_buffers_size不生效
重点调大 proxy_buffer_size 防 502 错误
这个参数只管响应头（status line + headers），和响应体无关，但极易触发 502：
- 默认 4k 太小，JWT token、多个 Set-Cookie、调试用 Header（如 X-Debug-Info）很容易撑爆
- 建议从
16k起，在 location 块中直接设置：proxy_buffer_size 16k; - 必须放在
proxy_pass之前，且不能被外层 server/http 块覆盖 - 若启用 HTTP/2，还需同步检查
http2_max_field_size（默认也是 4k），否则 HPACK 解码失败也会 502
按响应体量配 proxy_buffers 和 busy 区
这两个参数协同管理响应体的内存缓冲：
-
proxy_buffers 8 256k：共分配 2MB 缓冲空间（8 × 256k），用于暂存响应体数据 -
proxy_busy_buffers_size 512k：定义“正在发送给客户端”的缓冲区总上限，建议设为proxy_buffers总和的 1/2～1 倍 - 如果响应体远超缓冲总量，Nginx 会写临时文件——需确认
proxy_temp_path可写，且proxy_max_temp_file_size合理（例如1024m）
配套调优不可少
缓冲效果依赖整体代理链路稳定性：
- 流式场景关 buffering 后，务必延长超时：
proxy_read_timeout 300;（SSE/LLM 常需数分钟） - 避免后端重复注入 header，排查是否真需要大 header（比如中间件未清理调试字段）
- 可通过
curl -I或 Nginx 日志$upstream_http_content_length观察实际响应大小，再反推缓冲配置是否匹配
