proxy_set_body 是 Nginx 用于重写或替换请求体的关键指令，仅作用于 POST/PUT/PATCH 等含 body 的请求，需在 location 块中配置，依赖 $request_body 变量且要求 body 已完整读入内存。
proxy_set_body 是 Nginx 在反向代理场景中用于重写或替换原始请求体（request body）的关键指令，适用于需要在网关层统一修改、补充、过滤甚至伪造请求内容的场景（如鉴权注入、日志标记、协议适配、字段标准化等）。它不改变 URI 或头部，只作用于 HTTP 请求的 body 部分。
一、proxy_set_body 的基本用法和限制
-
语法：
proxy_set_body <value>;
其中<value>可以是：- 静态字符串（如
"{}"） - Nginx 内置变量（如
$request_body、$arg_token） - 变量拼接（如
"{'trace_id':'$request_id','body':$request_body}"） - 空值（如
""，表示清空 body）
- 静态字符串（如
生效位置：仅在
location块中有效（不能在http或server级直接使用）前提条件：必须启用
proxy_pass_request_body on;（默认开启，但显式声明更稳妥）注意：若原始请求为
GET或HEAD，无 body，该指令无效；对POST/PUT/PATCH等有 body 的方法才起作用。
FastAPI Flask Proxy下载FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
二、常见重构场景与配置示例
✅ 补充固定元数据（如 trace_id、gateway_id）
location /api/v1/order {
proxy_pass http://backend;
proxy_pass_request_body on;
# 将原始 body 包裹进新 JSON，并注入网关标识
proxy_set_body '{"gateway":"nginx-proxy","trace_id":"$request_id","original":$request_body}';
}⚠️ 注意：$request_body 必须在 proxy_pass 之前读取，因此需确保 client_max_body_size 足够，且 client_body_buffer_size 不过小（否则 body 可能被临时文件缓存，导致 $request_body 为空）。
✅ 替换敏感字段（如脱敏手机号）
Nginx 原生不支持正则替换 body，但可通过 sub_filter 配合 proxy_set_body + proxy_buffering off 实现简单替换（仅限文本型 body，如 JSON）：
location /api/v1/user {
proxy_pass http://backend;
proxy_pass_request_body on;
proxy_buffering off; # 关闭缓冲，让 sub_filter 生效
proxy_set_body $request_body;
# 替换 body 中的 "phone":"138..." → "phone":"***"
sub_filter '"phone":"[^"]*"' '"phone":"***"';
sub_filter_once off;
}✅ 清空 body 并转为固定 payload（如强制统一格式）
location /webhook/notify {
proxy_pass http://worker;
proxy_pass_request_body on;
proxy_set_body '{"event":"received","ts":$msec}';
}✅ 条件性设置 body（结合 if 或 map）
虽然 if 在 location 中受限，但可借助 map 提前构造值：
# http 块中定义
map $arg_format $payload {
default $request_body;
"xml" "<root><msg>converted</msg></root>";
"json" '{"format":"json","data":$request_body}';
}
location /convert {
proxy_pass http://backend;
proxy_pass_request_body on;
proxy_set_body $payload;
}三、关键注意事项
-
$request_body只在proxy_pass执行前可用，且依赖client_body_in_file_only off（默认）；若 body 过大触发临时文件存储，$request_body会为空。 - 若需保留原始 body 同时添加字段，推荐用 JSON 拼接方式（如上例），避免破坏结构。
- 不支持对 multipart/form-data 或 binary body 做结构化修改；这类请求建议交由后端处理，或改用 Lua（
ngx_http_lua_module）增强能力。 -
proxy_set_body不影响Content-Length头，Nginx 会自动重算并覆盖；但若手动设置Content-Length，可能引发长度不匹配错误，应避免。
不复杂但容易忽略：真正起效的前提是——body 已被完整读入内存，且未被丢弃或流式转发。
