proxy_pass_request_body 不支持变量或条件判断，只能设为 on/off；需用 lua 或 map 配合 proxy_set_body 实现按需透传，同时调整 client_body 相关参数确保稳定性。
不能直接用 proxy_pass_request_body 做动态开关，它只接受 on 或 off 字面值，不支持变量或条件判断。真要实现“按需透传 body”，必须借助外部机制介入请求生命周期。
核心限制：proxy_pass_request_body 无条件执行
该指令在配置解析阶段即固化行为，运行时不可变。写成 proxy_pass_request_body $flag 会报错——Nginx 不允许在此处引用变量。
-
proxy_pass_request_body off：彻底禁用 body 透传，后续必须用proxy_set_body显式提供内容 -
proxy_pass_request_body on（默认）：原样转发客户端 body，无法中途截断或替换 - 不存在中间态，也没有 if / map / rewrite 阶段可干预的钩子
可行替代方案：用 Lua 控制 body 读取与重写
OpenResty 环境下，通过 access_by_lua_block 或 body_filter_by_lua_block 在请求处理中动态决定是否读取、修改或丢弃 body。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 调用
ngx.req.read_body()主动加载 body（避免延迟读取导致后续不可用） - 用
ngx.req.get_body_data()获取原始内容，再根据 header、URI 或其他条件判断是否保留 - 若需清空，调用
ngx.req.set_body_data("")；若需替换，设新字符串并确保长度合理 - 最后仍需配
proxy_pass_request_body on，因为 Lua 修改的是 Nginx 内部 buffer，不是绕过透传逻辑
轻量级绕行：用 proxy_set_body + map 预判简单场景
适用于仅基于请求头或 URI 路径做粗粒度控制的情况，不涉及 body 内容解析。
- 先用
map指令将条件映射为字符串变量，例如：map $http_x_no_body $injected_body { "1" ""; default '{ "via": "nginx" }'; } - 再在 location 中启用
proxy_pass_request_body off，并设置proxy_set_body $injected_body - 注意：此法无法检查 body 内容本身，只能响应外部信号（如特定 header 存在）
必须同步调整的底层行为
无论选哪种路径，都要防止 body 处理异常影响连接稳定性：
- 设
client_body_in_single_buffer on，确保 body 被完整载入内存供 Lua 或变量引用 - 关
client_body_in_file_only off，避免临时文件干扰或变量失效 - 调大
client_max_body_size，防止因 body 过大触发 413 而中断流程 - 对高并发场景，Lua 中避免 JSON 解析大 body，可改用正则提取关键字段降低开销
