发布时间:2026-09-30 12:30 更新时间:2026-09-30 12:30 阅读量:14
做接口联调时经常碰到一种怪现象:前端 POST 一个 JSON 或上传一个文件,Nginx 日志里返回 200 或 400,但后端服务打印出来的请求体是空的,或者干脆只收到一半。前端说数据发出去了,后端说没收到,锅在谁身上?多数时候问题就夹在 Nginx 的请求体处理链路上:客户端到 Nginx 这一段的缓冲策略、Nginx 到上游这一段的转发策略,以及 Expect: 100-continue 这个容易被忽略的握手,三者相互影响。本文把这条链路拆开讲,并给出可以直接照做的排查命令。
客户端发起 POST 时,HTTP 请求分成头部和请求体两部分。Nginx 收到请求后,默认并不会先读完整个请求体再转发,而是先读头部,判断是否需要缓冲。是否缓冲由 client_body_buffer_size 决定:请求体小于这个阈值时放在内存缓冲区;超过阈值则边读边写入 client_body_temp_path 指定的临时文件。这个阶段纯粹是 Nginx 与客户端之间的事,和上游无关。
真正影响上游能不能拿到 body 的,是 Nginx 什么时候开始连接上游、什么时候把 body 发出去。这里的关键开关是 proxy_request_buffering。它默认为 on,表示 Nginx 会先把整个请求体读完(或落盘),再向上游建立连接并发送请求。好处是上游收到的 body 是完整的,客户端网络慢也不会拖住上游;代价是大文件上传会先占一份磁盘临时空间,且客户端上传期间上游连接还没建立,表现为"后端迟迟看不到请求"。
把它设为 off 后,Nginx 会把客户端的请求体流式转发给上游,即边收边转。这种模式对后端做流式处理、上传大文件省磁盘很有用,但它引入了一个前提:上游必须先把请求头读完并做出响应准备,否则流式转发可能在上游还没 ready 时就开始了。这就是 100-continue 登场的场景。
当客户端携带 Expect: 100-continue 时(curl 上传大文件、部分语言的 HTTP 客户端会这样发),客户端的逻辑是:先只发请求头,等服务器回一个 100 Continue 的中间响应,确认服务器愿意接收了,再发请求体。这本来是为了避免白白上传一个被拒绝的大文件。
问题在于 Nginx 默认并不总是替上游回这个 100。相关指令是 proxy_http_version 与上游协议行为:在 HTTP/1.1 下,Nginx 收到带 Expect 的请求时,通常会先向上游转发请求头,让上游决定是否回 100;上游回了 100,Nginx 再转给客户端,客户端才发 body。如果这中间任一环节的客户端或上游实现不规范——比如上游框架根本不理 Expect、直接等 body,而客户端又在等 100——双方就会互相等,最终超时或 body 为空。还有一种情况是客户端等待 100 超时后自己把 body 发了,但上游已经在超时后返回了 400,body 被丢弃。
排查时先确认现象属于哪一类:是"上游完全没收到 body",还是"上游收到 body 但解析失败",还是"客户端等到超时"。这决定了你是该看 client_max_body_size,还是该看 100-continue 的链路。
第一类误配是 client_max_body_size 太小。它限制的是客户端请求体的最大值,超出时 Nginx 直接返回 413,而不是把 body 转给上游。注意它默认值较小,很多框架上传接口在 Nginx 层就被拦了,上游自然收不到。它和 client_body_buffer_size 是两回事:前者是"允不允许",后者是"放内存还是放磁盘"。
第二类误配是 proxy_request_buffering off 配合 proxy_pass 使用 HTTP/1.0 请求。HTTP/1.0 默认不支持 chunked 传输,流式转发时 Nginx 需要额外处理,某些老上游会因此读不到 body。让上游走 HTTP/1.1 更稳妥。
第三类是超时与重试:proxy_send_timeout 太短,Nginx 在还没把 body 发完时就断开上游;或 proxy_next_upstream 包含 error 时,请求被重试到另一台上游,而 body 流已经消费过,重试的那台就收到空 body。
现场定位建议按下面顺序做。先看 Nginx 当前实际生效的配置和错误日志:
# 查看 Nginx 实际加载的完整配置,确认参数没被上层覆盖
nginx -T 2>/dev/null | grep -E "client_max_body_size|client_body_buffer_size|proxy_request_buffering|proxy_http_version"
观察错误日志里是否有 413、upstream 提前关闭等线索
tail -f /var/log/nginx/error.log
然后直接抓包看 body 到底有没有发到上游。假设上游监听 8080:
# 在 Nginx 所在机器抓取发往上游的流量,-A 打印 ASCII 内容方便看请求体
tcpdump -i any -A -s 0 'tcp port 8080 and (tcp[((tcp[12:1] & 0xf0) >> 2):4] = 0x504f5354)'
或者在客户端一侧用 curl 复现,强制携带 Expect 看服务端反应
curl -v -H 'Expect: 100-continue' -X POST --data-binary @bigfile.bin https://example.com/api/upload
curl 的 -v 输出会明确显示是否收到 HTTP/1.1 100 Continue,以及服务端最终返回的状态码,这是判断 100-continue 链路是否通的最快方式。如果上游收到了请求头却一直等不到 body,可以临时把 proxy_request_buffering 设回 on 验证:若设 on 后上游能正常收到,说明问题出在流式转发与上游读取时序上,而不是 body 本身没发。
一个折中的配置写法是:对普通接口保持默认缓冲,只对明确的大文件上传路径关闭缓冲并调大 body 限制。示例(仅示意,参数按实际环境调整,以官方文档为准):
location /api/upload {
client_max_body_size 500m;
client_body_buffer_size 256k;
proxy_request_buffering off;
proxy_http_version 1.1;
proxy_pass http://backend_upload;
proxy_send_timeout 300s;
proxy_next_upstream error timeout;
}
改完用 nginx -t && nginx -s reload 生效,再重复一次抓包确认。需要提醒的是,关闭 buffering 后上游会直接承受客户端上传速度,如果上游是处理慢的同步框架,反而容易堆连接,这时更合适的做法是保留缓冲、只把 client_max_body_size 和临时目录容量规划好。
POST body 丢失不是单一参数的问题,而是"客户端 → Nginx 缓冲 → 上游转发"三段里某一段的时序或限制被打破。先确认是 413 被拦、100-continue 握手卡住,还是流式转发与上游读取不同步,再针对性地调 client_max_body_size、proxy_request_buffering 与 proxy_http_version。动手前用 nginx -T 看清实际生效值,用 tcpdump 和 curl -v 拿到链路证据,比反复猜配置要省事得多。
| 📑 | 📅 |
|---|---|
| nohup 与 systemd-run 后台任务取舍:SSH 断开进程被杀排查 | 2026-09-30 |
| PostgreSQL慢查询定位:pg_stat_statements安装与top SQL排序实战 | 2026-09-30 |
| Docker容器ulimit不生效排查:句柄继承链路与优先级 | 2026-09-30 |
| Nginx 与后端 HTTP/2 与 HTTP/1.1 混用排查:协议协商与日志字段 | 2026-09-30 |
| MySQL 8 表被锁等待排查:从 INNODB_TRX 到阻塞源头 | 2026-09-30 |
| MySQL 8 慢查询日志查不到 SQL:digest 归并与真实语句还原 | 2026-09-30 |
| Redis连接数暴涨却无慢命令:连接泄漏定位实战 | 2026-09-30 |
| Linux磁盘满了但df与du不一致:挂载点遮蔽排查 | 2026-09-30 |
| Nginx日志499与502混合:按时间窗口对齐后端日志定位 | 2026-10-01 |
| 容器OOM Kill但宿主内存充足:cgroup统计口径与memory.max排查 | 2026-10-01 |