如何通过调优 proxy_send_timeout 兼容慢速移动网络环境下的代理上传-Nginx-PHP中文网

proxy_send_timeout仅控制Nginx向后端发送请求体的超时，适用于非长连接场景，不解决客户端上传慢问题；需与client_body_timeout、client_max_body_size等协同配置，并确保后端及时读取。

如何通过调优 proxy_send_timeout 兼容慢速移动网络环境下的代理上传

proxy_send_timeout 本身不处理客户端上传慢的问题，它只管 Nginx 向后端发请求体的那段过程。在慢速移动网络下，真正卡住的环节通常是客户端往 Nginx 传数据，而不是 Nginx 往后端传——所以单调 proxy_send_timeout 不解决问题，反而容易掩盖真实瓶颈。

要让代理上传在弱网（如 3G、高延迟、丢包率高）下稳定，关键得搞清数据流向，并分层设防：

明确各环节谁在等谁

客户端 → Nginx：靠 client_body_timeout 控制两次数据包之间的空闲时间
Nginx → 后端：靠 proxy_send_timeout 控制发送 body 过程中等待 ACK 的耐心
后端自身：必须能及时读取 socket，否则 Nginx 发出去也没人收，照样触发超时

移动端上传中断，90% 出现在第一段（客户端传不稳），不是第三段（后端收得慢）。

WebChat Voice Proxy

⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**

下载

针对弱网上传的合理配置组合

client_body_timeout 120;
移动端网络抖动常见，允许两次数据包间隔最长 2 分钟，避免因短暂卡顿被断连
client_max_body_size 500m;
根据业务定上限，防止攻击者用超大 body 拖死连接；500MB 覆盖绝大多数 App 场景
proxy_send_timeout 180;
仅当后端接收也偏慢（如 Java 应用未启用流式读取、中间有 WAF 缓冲）时才需同步拉长；设 3 分钟留出余量
proxy_buffering off;（可选）
若后端支持流式处理（如 Node.js 或 Spring WebFlux），关缓冲可减少 Nginx 中转延迟，让数据更直通

这些都应写在具体上传路径的 location 块里，例如：

location /api/v1/upload {
    proxy_pass http://backend;
    client_body_timeout 120;
    client_max_body_size 500m;
    proxy_send_timeout 180;
    proxy_buffering off;
}

必须同步检查的后端配合项

Spring Boot：确认 spring.servlet.multipart.enabled=true 且 max-file-size 和 max-request-size ≥ Nginx 设置
Node.js（Express）：body-parser 的 limit 和 timeout 要放宽，或改用 busboy 直接流式处理
Python（FastAPI）：request.form() 前确保未触发完整内存加载；大文件务必用 UploadFile + await file.read() 分块

不复杂但容易忽略