需启用请求体缓存并精准配置路径日志：设置client_body_buffer_size与client_max_body_size，配合proxy_buffering on或ngx.req.read_body()，在location /api/v1/secure中定义专用log_format记录$request_body，同时过滤非body方法及content-type，注意脱敏与性能监控。
直接使用 $request_body 记录原始请求体在 Nginx 中是受限的——默认情况下它为空，除非明确启用相关配置且满足特定条件。要实现对特定非对称加密路径（例如 /api/v1/secure）的入参报文全量记录，需结合请求体读取、日志格式定制与安全边界控制，而非简单开启变量。
必须启用 request body 缓存
Nginx 默认不缓存请求体，$request_body 仅在以下情况非空：
- 使用了
proxy_pass、fastcgi_pass等代理指令，且未显式禁用缓存； - 配置了
client_body_buffer_size和client_max_body_size，确保常见报文能载入内存或临时文件； - 关键：添加
proxy_buffering on;（对 proxy 场景）或确保fastcgi_request_buffering on;（对 PHP-FPM）； - 若用
lua-resty-http或 OpenResty，可通过ngx.req.read_body()主动读取并赋值给自定义变量。
按路径精准匹配并隔离日志输出
避免全局记录敏感数据，应仅对目标路径启用报文捕获：
- 用
location = /api/v1/secure精确匹配，或location ~ ^/api/v1/secure支持带参数路径； - 在该 location 内定义独立 log_format，例如：
log_format secure_log '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$request_body"'; - 搭配
access_log /var/log/nginx/secure.log secure_log;单独落盘； - 注意：若请求体超长（如 > client_body_buffer_size），
$request_body会变为"..."或空，需同步检查$request_body_file并配合client_body_temp_path定位临时文件（生产环境慎用，涉及磁盘 I/O 与清理）。
处理非对称加密报文的注意事项
加密 payload 本身不可读，但记录原始字节仍有审计价值。需规避常见陷阱：
- HTTP 方法限制：仅
POST、PUT、PATCH等含 body 的方法才可能有$request_body，GET 请求始终为空； - Content-Type 过滤：可加
if ($content_type !~ "application/json|application/x-www-form-urlencoded") { access_log off; }减少无效记录； - 敏感字段脱敏（可选）：Nginx 原生不支持正则替换 body，若需掩码（如密钥、token），建议在 upstream 服务层处理，或用 OpenResty 的
ngx.re.gsub在 log_by_lua* 阶段处理（需编译 Lua 模块）； - 性能权衡：全量记录 request body 会显著增加日志体积与磁盘压力，建议设置 rotation 策略（如 logrotate 按日/大小切分）并监控
secure.log增长速率。
验证与调试要点
上线前务必实测，避免日志“看似开启实为空”：
- 用 curl 发送标准 JSON：
curl -X POST https://example.com/api/v1/secure -H "Content-Type: application/json" -d '{"data":"encrypted"}'； - 检查 Nginx error.log 是否有
client intended to send too large body或request body buffer overflow报错； - 临时在 location 内加
add_header X-Body-Length $request_body_length;，响应头中确认 body 被正确读取； - 若仍为空，尝试在 location 中加入
proxy_set_body $request_body;（proxy 场景）强制触发 body 缓存。
不复杂但容易忽略：$request_body 不是开箱即用的“开关”，而是依赖 Nginx 处理阶段与缓冲策略协同的结果。聚焦路径、控制范围、验证实效，才能让审计日志真正可信可用。
