Nginx 怎么在 Nginx 中排查因为客户端网络太慢导致的 `A client request body is buffered to a temporary file` 告警-Nginx-PHP中文网

该告警是nginx正常notice级别日志，表示请求体从内存转存磁盘；仅当频繁出现并伴随499/500或超时才需排查，须结合$request_time、$upstream_response_time、status及tcpdump等交叉验证是否真为客户端网络慢。

nginx 怎么在 nginx 中排查因为客户端网络太慢导致的 `a client request body is buffered to a temporary file` 告警

这个告警本身不是错误，而是 Nginx 的正常日志级别（notice），表示它把客户端上传的请求体（比如大文件、长表单）从内存缓冲区转存到了磁盘临时文件。但当它频繁出现、伴随超时或 499/500 状态时，才说明客户端网络慢或上传行为异常，需要排查。

不能只看这条日志就断定是“客户端太慢”，得结合上下文判断：

检查对应请求的 $request_time 和 $upstream_response_time（如果用了 upstream）。若 $request_time 远大于 $upstream_response_time，说明请求接收耗时长，大概率是客户端上传慢；
查看 access log 中该请求的 status 和 bytes_sent：如果 status 是 499（客户端主动断开）或 0（无响应），且 bytes_sent 很小，基本可确认是客户端中断上传；
用 tcpdump 或 Wireshark 抓包（生产环境慎用），观察 TCP 窗口是否长期为 0、ACK 延迟高、重传多——这是典型弱网表现。

不是调得越大越好，而是让 Nginx 更合理地应对慢客户端：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

client_body_buffer_size：默认 8k，小文件走内存；若大量中等上传（如 1–5MB），可设为 128k 或 256k，减少落盘频率；
client_max_body_size：确保不因大小限制触发 413，但也不宜过大（防 DoS），按业务上限设（如 100m）；
client_body_timeout：默认 60s，指两次连续 body 数据包之间的最大间隔。慢网用户可能发得很慢，可适度提高到 120s，避免过早断连；
client_header_timeout 和 keepalive_timeout 也要同步评估，防止连接在 header 阶段就断。

默认 error log 只告诉你“buffered to file”，无法知道是谁、什么请求、多慢。加字段辅助分析：

在 log_format 中加入：$request_length $request_time $upstream_response_time $status；
对 upload 相关 location，单独开一个 access log，记录更细字段（如 $body_bytes_sent、$connection_requests）；
配合 limit_req 或 map 指令，对 request_time > 30s 的请求打标（如加 header X-Slow-Upload），便于后端或监控识别。

单靠 Nginx 日志很难还原真实场景，需交叉验证：

前端埋点记录上传 start/end 时间、分片上传各 chunk 耗时、网络类型（4G/WiFi）、丢包率（如有 WebRTC 或 Network Information API）；
服务端（如后端应用）记录收到完整 body 的时间戳，与 Nginx 的 $request_time 对比，确认瓶颈在接入层还是上游；
模拟弱网测试：用 tc（Linux traffic control） 或 Clumsy（Windows） 限速 100kbps + 高延迟，复现并观察 Nginx 行为是否符合预期。