nginx反向代理的请求体缓冲核心是通过proxy_buffering、client_max_body_size等参数协同控制接收与转发行为；默认启用缓冲，设为off可实现流式透传，配合client_body_buffer_size、client_body_temp_path及超时机制优化大请求处理。
HTTP 代理实现反向代理请求缓冲，核心是控制 Nginx 如何接收、暂存并转发客户端请求体（request body）以及如何缓存后端响应体（response body）。缓冲不是默认全开，而是通过一组明确指令协同控制，目的是平衡性能、内存占用与流式处理需求。
启用和控制请求体缓冲
当客户端上传文件或提交大表单时，Nginx 默认会先将整个请求体读入内存或临时文件，再整体转发给后端——这就是请求体缓冲。关键参数是 proxy_buffering 和 client_max_body_size：
-
proxy_buffering on;（默认开启）：启用缓冲机制，Nginx 会等待完整接收请求体后再发往后端；设为
off则以流式方式边收边转，适合大文件上传或 WebSocket 场景 -
client_max_body_size 100m;：限制客户端可上传的最大请求体大小，超出返回 413 错误；需配合
proxy_buffering on才有效触发磁盘暂存 - proxy_buffer_size 128k;：设置用于存储响应头的缓冲区大小（最小单位），必须足够容纳后端返回的全部响应头
-
proxy_buffers 8 128k;：定义用于响应体的缓冲区数量和单个大小，例如
8 128k表示最多用 1MB 内存暂存响应体
配置响应体缓冲与刷新策略
响应缓冲决定 Nginx 是等后端发完全部内容再返回，还是边收边吐给客户端。这对长连接、SSE 或实时日志类接口很关键：
- proxy_buffering off;：禁用响应缓冲，Nginx 收到一点就转发一点，延迟低但无法做响应头修改或压缩
- proxy_buffering on; + proxy_busy_buffers_size 256k;：指定繁忙状态下最多使用的缓冲区上限，防止阻塞新请求
-
proxy_max_temp_file_size 1g;：当响应体超过内存缓冲总量时，允许写入临时文件的最大尺寸；设为
0则禁止磁盘缓冲 - proxy_cache_valid 200 302 10m;：若同时启用缓存模块，该指令定义哪些状态码响应可被缓存及有效期
影响缓冲行为的关键头部与透传设置
某些 HTTP 头部会直接影响缓冲逻辑，尤其在后端主动分块传输（chunked encoding）或要求流式响应时：
-
proxy_ignore_client_abort off;（默认）：客户端中断连接时，Nginx 同步中止对后端的请求；设为
on可让后端继续执行（如异步任务），但需谨慎使用 -
proxy_set_header X-Accel-Buffering $sent_http_x_accel_buffering;：透传或覆盖后端返回的
X-Accel-Buffering头，该头值为no时强制禁用本请求的响应缓冲 -
proxy_pass_request_headers on;：确保原始请求头（如
Transfer-Encoding）被正确传递，避免因头缺失导致缓冲判断异常
典型场景下的配置组合
不同业务类型需要不同缓冲策略，不能一概而论：
-
普通 Web 页面/API：保持
proxy_buffering on，搭配合理proxy_buffers和proxy_busy_buffers_size，提升吞吐和首字节时间 -
文件上传服务：设
client_max_body_size足够大，proxy_buffering on，并确保proxy_max_temp_file_size允许磁盘暂存 -
实时日志推送或 SSE 接口：必须设
proxy_buffering off，并添加proxy_http_version 1.1;和proxy_set_header Connection '';保持长连接 -
动静分离中的静态资源：建议关闭缓冲（
proxy_buffering off）+ 开启sendfile on;，由内核直接零拷贝传输
