如何通过 proxy_set_body 在转发请求前动态修改或注入请求体内容-Nginx-PHP中文网

Nginx 的 proxy_set_body 不支持动态修改请求体，仅接受静态字符串或已加载的变量（如 $request_body）；需通过 client_body_in_single_buffer 等配置确保 $request_body 可用，并结合 map、Lua 或外部服务实现条件注入或 JSON 字段级修改。

如何通过 proxy_set_body 在转发请求前动态修改或注入请求体内容

proxy_set_body 本身不支持动态生成或条件性修改请求体，它只接受静态字符串或变量（如 $request_body、$args），且变量必须在 location 块中已存在、未被清空。真正实现“动态修改或注入请求体”，需结合 Nginx 的其他机制协同完成。

确保 $request_body 可用是前提

Nginx 默认在多数场景下不缓存原始请求体（尤其非 POST/PUT），导致 $request_body 为空。必须显式启用缓冲：

设置 client_max_body_size（避免因超限直接拒绝）
设置 client_body_buffer_size（建议 ≥ 最大预期请求体大小）
关键：启用 client_body_in_single_buffer on 和 client_body_in_file_only off（确保 body 始终在内存中、可被变量引用）
若使用 proxy_pass_request_body off，则需手动用 proxy_set_body 提供内容，否则转发无 body

用 map + $request_body 实现简单条件注入

适用于基于请求头、URI 或参数决定是否追加固定内容的场景（如注入 trace_id）：

Nginx Reverse Proxy

配置 Nginx 反向代理，实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发，将域名绑定到指定 IP:端口。

下载

先用 map 定义规则，例如：

map $http_x_trace_id $injected_body {
    ""      "$request_body";
    default "$request_body\nX-Trace-ID: $http_x_trace_id";
}

在 location 中：
```
proxy_set_body $injected_body;
```
注意：$request_body 必须已加载（见上一节配置），且 map 中不能执行复杂逻辑（如 JSON 修改、字段插入）

对 JSON 请求体做字段级修改需外部程序介入

Nginx 原生不解析 JSON，无法直接增删 key。可行路径有两条：

用 Lua（OpenResty）：在 access_by_lua_block 或 body_filter_by_lua_block 中读取 $request_body → 解析 JSON → 修改 → 覆盖 $request_body → 再 proxy_set_body；需注意内存和性能开销
用 post_action + 后端代理服务：Nginx 将原始请求暂存为文件或传给轻量服务（如 Python Flask），由该服务修改 body 后返回新内容，再用 proxy_pass 转发其响应；适合复杂逻辑但增加延迟

常见陷阱与绕过方式

$request_body 在 rewrite 阶段不可用：只能在 access 阶段及之后（如 proxy_set_body 所在的 location）访问
GET/HEAD 请求无 body：$request_body 恒为空，proxy_set_body 对其无效；不要试图给 GET 注入 body
multipart/form-data 难以安全处理：边界符（boundary）易被破坏，不建议用变量拼接修改；应交由后端或 Lua 库（如 lua-resty-upload）解析
若只需添加 HTTP 头（非 body），优先用 proxy_set_header，更安全高效