proxy_pass_request_body off 是禁用请求体透传的核心配置，需配合 proxy_set_body 显式设置内容，否则上游可能因无 body 返回400/411错误；常用于剥离原始body并注入固定payload或清空body的代理场景。
当需要只转发请求头、不转发原始请求体时，proxy_pass_request_body off 是核心配置项。它直接禁用请求体的透传，但必须配合 proxy_set_body 显式提供新内容，否则上游将收不到任何请求体（包括空 body）。
基础配置逻辑
默认情况下，Nginx 会把客户端的请求头和请求体一并转发给上游。设为 off 后，Nginx 不再自动携带原始 body，此时若不手动设置，上游收到的是无 body 的请求（HTTP 方法如 POST/PUT 可能被后端拒绝或行为异常）。
-
proxy_pass_request_body off;必须放在location块中，且需与proxy_pass配合使用 - 只要上游期望接收 body（比如 JSON API），就必须用
proxy_set_body指定内容，哪怕只是空字符串"" - 若上游仅依赖 header（如某些鉴权或路由场景），设为
off并省略proxy_set_body，可能导致 400 或 411 错误，取决于后端是否校验 body 长度
常见适用场景与写法
该配置多用于“剥离原始 body、注入控制字段”或“统一转为固定 payload”的代理逻辑。
- 强制清空 body：
proxy_pass_request_body off;<br>proxy_set_body "";
适用于健康检查探针或某些只读接口的前置代理 - 替换为固定 JSON：
proxy_pass_request_body off;<br>proxy_set_body '{ "source": "nginx-proxy", "timestamp": $msec }';注意：变量如$msec在proxy_set_body中可用，但不能拼接复杂结构；JSON 字符串需确保引号转义正确 - 条件性注入（需配合 map 或 Lua）：
单纯靠
proxy_pass_request_body off无法实现“有某 header 才注入”，必须引入外部机制判断，再动态赋值给proxy_set_body
必须同步调整的缓冲配置
即使不转发 body，Nginx 仍需完整读取客户端请求才能解析 header 和 URI。若未启用缓冲，proxy_pass_request_body off 可能导致连接异常或 body 未被完全读取就中断。
- 确保
client_max_body_size设置合理（避免因超限直接 413） - 建议开启
client_body_in_single_buffer on;，让 Nginx 把整个 body 缓存在内存中（即使不用） - 关闭文件缓存：
client_body_in_file_only off;，防止 body 被写入临时文件而影响性能或变量引用
与 proxy_set_header 的协同要点
仅关 body 不代表 header 就安全透传。如果同时需要控制 header 行为：
- 默认
proxy_pass_request_headers on，header 仍会转发 - 若想过滤特定 header，用
proxy_hide_header X-Original-Body-Length; - 若需添加新 header（如标记代理动作），用
proxy_set_header X-Proxy-Action "body-dropped"; - 注意：
proxy_set_header不影响 body，但它和proxy_pass_request_body off可共存，各自独立生效
