调大 client_body_buffer_size 并不能自动提升 POST 转发缓存性能，关键在于缓存逻辑是否依赖完整请求体、Nginx 是否内存中完整缓冲并可靠提供 $request_body，需结合 client_body_in_single_buffer、proxy_cache_methods、缓存 key 设计及 debug 验证协同优化。

直接调大 client_body_buffer_size 并不能自动提升带缓存逻辑的 POST 转发性能——它只影响请求体“存放位置”，而缓存逻辑是否生效，取决于后端是否真正读取了完整请求体、以及 Nginx 是否在转发前就完成了缓冲。关键在于让缓存判断（如基于 body 内容哈希或字段提取）能高效、确定地执行，避免因落盘或分片导致延迟或失败。

明确缓存逻辑对请求体的依赖方式

不是所有 POST 缓存都需要完整 body：有些只需解析 header 或前几 KB（如签名字段、token），有些则必须读全（如基于 JSON payload 计算 etag）。确认你的缓存逻辑属于哪一类，再决定是否需要全程内存驻留：

• 若缓存判断仅依赖固定位置的字段（如 POST /api/v1/submit 中的 {"id":"abc123"}），可配合 lua-resty-http 或 auth_request 模块提前截取并解析，无需增大 buffer
• 若需完整 body（如计算 SHA256 后查缓存），就必须确保整个 body 在内存中可用，此时 client_body_buffer_size 至少 ≥ 常见请求体大小，否则部分数据在磁盘，无法原子读取
• 若使用 proxy_cache 对 POST 响应做缓存，Nginx 默认不缓存 POST 响应；需显式配置 proxy_cache_methods POST; 和 proxy_cache_key，且 key 中包含 $request_body 时，client_body_buffer_size 必须足够，否则变量为空或不完整

避免因落盘破坏缓存一致性

当请求体超出 client_body_buffer_size，Nginx 将剩余部分写入临时文件，而 $request_body 变量默认只返回内存中的部分（除非启用 client_body_in_single_buffer on）。这会导致缓存 key 不稳定：

• 小请求（≤ buffer）：key = "POST:/path:{"a":1}" → 命中缓存
• 稍大请求（＞ buffer）：$request_body 为空或截断 → key = "POST:/path:" → 缓存 miss 或错配
• 解决方案：启用 client_body_in_single_buffer on;，强制 Nginx 尝试将整个 body 放入单块内存（需 buffer 足够大），再配合足够大的 client_body_buffer_size（如 1M），确保常见请求体全程在内存

与 proxy_pass 缓存链路协同配置

POST 请求经 proxy_pass 转发时，缓存行为受多个环节控制。仅调 buffer 不足以打通链路：

• 必须开启请求体读取：proxy 模块默认会调用 ngx_http_read_client_request_body()，但若后端支持流式接收（如 chunked），它可能跳过完整读取——此时缓存逻辑无 body 可用。可加 proxy_buffering off; 强制立即转发，但会牺牲缓存前提
• 缓存 key 必须可靠：推荐组合使用 $request_method:$request_uri:$request_body，并确保 client_body_buffer_size ≥ 95% 请求体大小，同时设置 client_max_body_size 略大于它（如 buffer=1m → max=2m），防止 413 中断流程
• 临时路径要可控：即使设了较大 buffer，极端情况下仍可能落盘。确保 client_body_temp_path /var/tmp/nginx/body 1 2; 所在分区有空间、权限正确，避免因写失败导致 500，进而破坏缓存可用性

验证缓存逻辑是否真正“看到”完整 body

不能只看日志是否有 “buffered”，而要看缓存模块实际拿到的数据：

• 开启 debug 日志：error_log /var/log/nginx/debug.log debug;，搜索 "http request body read" 和 "request body in memory"，确认无 "temp file" 出现
• 用 Lua 模块打印长度：set_by_lua_block $body_len { return tostring(tonumber(string.len(ngx.var.request_body)) or 0) }，在 access_log 中记录，观察是否稳定等于真实 body 大小
• 对关键接口构造边界测试：发送刚好等于 buffer 大小的 body（如 1024KB），再发大 1 字节（1025KB），对比两次缓存命中率和响应时间变化