必须关闭proxy_request_buffering——设为off才能实现边收边转，避免弱网下缓冲堆积导致499/504；还需同步调整client_max_body_size、client_body_timeout、proxy_buffering、proxy_http_version及proxy_ignore_client_abort等参数。
要提升弱网下文件上传的稳定性，关键不是“优化”proxy_request_buffering，而是必须关闭它——proxy_request_buffering off是实现边收边转、避免卡死的基础动作。弱网本身不改变Nginx对请求体的默认缓存逻辑，但会让默认的“等全量收完再转发”行为彻底失效：上传变慢 → 缓冲堆积 → 内存吃紧或超时中断 → 499/504频发。关掉它，才能把控制权交还给后端流式处理能力。
哪些弱网上传场景必须关掉 proxy_request_buffering
以下情况只要涉及“上传未完成但后端需立刻响应”，就应禁用该指令：
- 前端使用 fetch 或 XMLHttpRequest 分片上传大视频/音频（如每片8MB），后端基于 FFmpeg 或 AI 推理服务逐片处理
- IoT 设备在地铁、电梯等信号断续环境中持续推送传感器二进制流，服务端需毫秒级接收并触发告警
- 移动端 App 在 Wi-Fi 切 4G 过程中上传中途断连，但后端任务（如图片压缩、日志归档）不可中断
- 调试“上传卡在 99%”“后端只收到前几 KB”等问题时，关闭缓冲可暴露真实传输链路状态
只关 proxy_request_buffering 远远不够
单独写 proxy_request_buffering off; 只是启动流式转发，若不配套调整，仍会因超时、大小限制或响应积压而失败：
-
扩大请求体上限：弱网上传大文件耗时长，必须设
client_max_body_size 2G;（或按业务设合理值），否则直接返回 413 -
延长请求体接收超时：设
client_body_timeout 600;（单位秒），防止弱网传 100MB 时被中途断开 -
同步禁用响应缓冲：加
proxy_buffering off;，避免后端返回的进度流（如 {“progress”: 35}）被 Nginx 暂存，导致客户端收不到实时反馈 -
启用 HTTP/1.1 长连接：配
proxy_http_version 1.1;和proxy_set_header Connection "";，减少弱网下频繁建连带来的丢包风险
移动端弱网还需配合 proxy_ignore_client_abort
用户切后台、快速返回、网络静默断开时，客户端常主动关闭连接，Nginx 默认会立刻中止后端请求。此时需额外启用：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
-
proxy_ignore_client_abort on;：让 Nginx 忽略客户端断连，继续等待后端完成 - 但必须同步调大
proxy_read_timeout 300;，否则 Nginx 自己先超时，照样中断后端 - 建议仅在具体上传接口 location 中启用（如
location /api/upload），不全局开启
Kubernetes Ingress 中的正确写法
若使用 NGINX Ingress Controller，不能改 nginx.conf，而要通过注解配置：
nginx.ingress.kubernetes.io/proxy-request-buffering: "off"
注意：值必须是字符串 "off"（带英文双引号），不能写 false、off（无引号）或 0；配置后需登录 Ingress Controller Pod，检查生成的 nginx.conf 片段是否已生效。
