必须关闭proxy_request_buffering的场景包括：大文件分片上传、实时音视频流接入、AI推理请求流式输入及上传链路调试；需配套调大client_max_body_size、延长client_body_timeout、禁用proxy_buffering并启用HTTP/1.1长连接。
要实现极低延迟的文件流透传，proxy_request_buffering off 是关键一步——它让 Nginx 不再等待客户端发完全部请求体，而是边收边转，彻底规避缓冲堆积和首字节延迟。
什么场景必须关掉 proxy_request_buffering
该指令默认为 on，适用于普通表单提交等小载荷、短连接场景；但以下情况需明确设为 off：
- 大文件分片上传：如前端按 8MB/片上传视频或镜像，若 Nginx 缓存整片再转发，易触发内存溢出或超时中断
- 实时音视频流接入：后端是 FFmpeg 推流接收服务或 WebRTC 信令中继，要求请求体毫秒级透传
- AI 推理请求流式输入：例如上传音频片段+文本 prompt 后端逐 token 处理，不能等完整 body 才开始
- 调试上传链路问题：排查“上传卡在 99%”“后端收不到前几 KB 数据”等现象时，关闭缓冲可暴露真实传输行为
只关 proxy_request_buffering 还不够
单独设 proxy_request_buffering off 能启动流式转发，但若不配套调整，仍可能失败或不稳定：
-
必须配
client_max_body_size：Nginx 默认仅允许 1MB 请求体，上传大文件会直接返回 413。建议在对应 location 中设为client_max_body_size 2G; -
延长请求体接收超时：弱网下传 100MB 可能超 5 分钟，需调大
client_body_timeout 600;（单位秒），避免中途断连 -
禁用响应缓冲协同生效：若后端也返回大响应（如上传成功后的元数据 JSON），建议同步加
proxy_buffering off;，防止响应侧卡住 -
启用 HTTP/1.1 长连接：加上
proxy_http_version 1.1;和proxy_set_header Connection "";，减少 TCP 握手开销
典型 location 配置示例
以分片上传接口 /api/v1/upload/chunk 为例：
location /api/v1/upload/chunk {<br> client_max_body_size 2G;<br> client_body_timeout 600;<br> proxy_pass http://backend_upload;<br> proxy_request_buffering off;<br> proxy_buffering off;<br> proxy_http_version 1.1;<br> proxy_set_header Connection "";<br> proxy_read_timeout 600;<br> proxy_send_timeout 600;<br>}
验证是否真正生效
光写配置不等于生效，可通过三步确认：
-
查 Nginx 错误日志：上传时若看到
client intended to send too large body，说明client_max_body_size未生效或位置错误 - 抓包观察 TCP 流：用 tcpdump 或 Wireshark 检查 Nginx 到后端的连接，应能看到请求体数据持续、分段发出，而非长时间静默后突然爆发
-
检查生成配置：进入 Nginx 容器或服务器，执行
nginx -T 2>/dev/null | grep -A5 "location /api/v1/upload/chunk"，确认指令确实被加载且无语法覆盖
