必须关闭 proxy_request_buffering 的场景包括：①后端需实时处理上传数据（如FFmpeg转码、AI边接收边推理）；②弱网客户端上传慢但后端不能等待；③WebSocket/SSE流式代理；④对接Jenkins CLI等依赖原始请求流的工具链。
禁用 proxy_request_buffering 能显著降低大文件上传或实时流式请求的端到端延迟，但不能单独生效——必须配合 proxy_buffering off、proxy_http_version 1.1 和超时调优，否则可能引发后端连接中断或客户端卡顿。
什么时候必须关掉 proxy_request_buffering
它控制 Nginx 是否把整个请求体（比如一个 500MB 的视频上传流）先收全再发给后端。关掉后，Nginx 边读边转，适合以下场景：
- 后端服务需要实时处理上传数据（如 FFmpeg 实时转码、AI 模型边接收边推理）
- 客户端是弱网设备，上传慢但后端不能等（否则会触发
proxy_read_timeout中断） - 使用 WebSocket 升级前的 HTTP 请求体透传，或 SSE 流式响应的反向代理链路
- 对接 Jenkins CLI 或某些 HTTP-based 工具链，它们依赖未缓冲的原始请求流（见 JENKINS-45651）
proxy_request_buffering off 的真实行为与陷阱
设为 off 后，Nginx 不再缓存请求体，而是直接以流方式转发。但这带来几个隐性变化：
Bailian Usage Proxy
下载
阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。
- 后端暴露于慢速客户端风险：如果客户端上传极慢，后端需自行控制读超时，Nginx 不再代为缓冲保护
- 无法做请求体完整性校验：比如你原本靠 Nginx 检查
Content-Length是否匹配再放行，关掉后这层就没了 - 不兼容
client_body_in_file_only on等磁盘缓存指令，二者互斥 - 在 Kubernetes Ingress 中必须用字符串
"off"，写成false或布尔值会导致配置被忽略
必须同步调整的配套参数
单设 proxy_request_buffering off 很容易出问题。这几个参数要一起改：
-
proxy_buffering off：防止响应也被缓冲，否则上传流进得快、响应出得慢，体验割裂 -
proxy_http_version 1.1：确保支持Transfer-Encoding: chunked，避免 Nginx 强制等待Content-Length -
proxy_set_header Connection ""：清空 Connection 头，防止中间设备误判连接复用状态 -
proxy_read_timeout 300（或更长）：给后端留足处理时间，避免 Nginx 在转发中途因超时断连 -
client_max_body_size 0：若上传无固定上限，设为 0 可禁用大小限制（注意后端是否能承受）
验证是否真正生效
光改配置不等于生效。确认方法有三：
- 进 Nginx 进程执行：
nginx -T 2>&1 | grep proxy_request_buffering，看输出是否为off - 在
error_log开debug级别，观察日志中是否有no buffering of client request body提示 - 用
curl -v -T largefile.zip http://your-proxy/upload抓包，检查 TCP 层是否出现连续小包发送（而非一次大块），且后端 access log 时间戳紧随客户端发送节奏
最容易被忽略的是：Kubernetes Ingress 配置修改后，必须确认 Ingress Controller Pod 内生成的 /etc/nginx/nginx.conf 确实包含了该指令——Ingress 注解不会自动注入到所有 location 块，有时需配合 nginx.ingress.kubernetes.io/configuration-snippet 手动补全。
