proxy_set_body仅支持静态字符串替换请求体，不支持变量插值；动态重构需借助map模块、rewrite指令或OpenResty的Lua脚本实现。
nginx 的 proxy_set_body 本身不支持变量插值（比如 $request_body、$arg_xxx 等），它只接受静态字符串或空值。所谓“利用变量实现动态重构”，实际是通过组合其他模块（如 ngx_http_rewrite_module、ngx_http_map_module）或借助 Lua（OpenResty）间接达成——原生 Nginx 核心并不允许在 proxy_set_body 值中直接使用请求体变量。
proxy_set_body 的真实能力边界
该指令仅用于完全替换原始请求体，且 value 必须是字面量字符串（含 JSON、表单编码等格式），例如：
proxy_set_body "{\"name\":\"nginx\",\"env\":\"prod\"}";proxy_set_body ""; # 清空请求体proxy_set_body "$body_bytes_sent"; # ❌ 错误：变量不被解析，会原样发送字符串 "$body_bytes_sent"
也就是说，它不能读取、解析或拼接原始 $request_body。Nginx 在读取请求体前就已决定是否缓冲（由 client_body_buffer_size 和 proxy_buffering 控制），而 proxy_set_body 是在转发阶段强制覆盖，与原始 body 无逻辑关联。
想“动态重构”？得绕过 proxy_set_body 本身
若需基于原始请求参数、路径、Header 或 body 内容生成新 body，必须借助外部机制：
-
用 map + proxy_set_body 静态映射：适用于有限、可枚举的场景。例如按 URL 路径选择预设 body：
map $uri $dynamic_body {<br> "/api/v1/user" "{"type":"user"}";<br> "/api/v1/order" "{"type":"order"}";<br> default "{"type":"unknown"}";<br> }
再在 location 中：proxy_set_body $dynamic_body; -
用 rewrite + query string 搬运关键字段：把参数转为 URL 查询项，后端再组装。例如：
rewrite ^/api/(.*)$ /backend/api/$1?name=$arg_name&age=$arg_age? break;
配合proxy_pass http://backend/;，后端从 query 获取字段并构造完整 body。 -
引入 OpenResty（推荐生产级动态需求）：用 Lua 脚本读取
ngx.req.get_body_data()，JSON 解析、修改、重设：access_by_lua_block {<br> local data = ngx.req.get_body_data()<br> if data then<br> local obj = cjson.decode(data)<br> obj.timestamp = ngx.time()<br> ngx.req.set_body_data(cjson.encode(obj))<br> end<br> }
常见误区与调试要点
很多人尝试写 proxy_set_body "$request_body"; 期望透传并微调，结果发现后端收不到 body 或内容为空——这是因为：
-
$request_body在非缓冲模式下为空；需先启用client_body_buffer_size和proxy_buffering on，但即便如此，Nginx 也不保证该变量在proxy_set_body上下文中可用； - 若原始请求是 chunked 编码或超大 body，Nginx 默认不缓存，
$request_body不可靠； - 使用
proxy_set_body后，原始 body 不再发送，所以不要指望它“追加”或“修改部分字段”，只能全量替换。
验证是否生效，可在后端打印接收的 raw body，并比对 Nginx access 日志中的 $request_length 与后端收到长度是否一致。
替代方案：更务实的选择
多数业务场景中，“动态重构 body”本质是协议适配问题。比起在 Nginx 层硬改，建议：
- 前端发请求时就构造好目标格式（最轻量）；
- 后端统一做适配层（如 Spring Cloud Gateway、Kong），它们原生支持 body 转换脚本；
- 若必须 Nginx 层处理，优先用
proxy_set_header传递上下文（如X-Original-Path: $uri），让后端自主决策 body 构造逻辑。
原生 Nginx 的设计哲学是“配置即策略”，而非“运行时编程”。理解这个边界，才能避开大量无效调试。
