Nginx 中怎么在日志中精准记录客户端发起的请求体完整内容-Nginx-PHP中文网

必须满足读取与缓存条件才能使$request_body非空：设置client_max_body_size、client_body_buffer_size和client_body_in_single_buffer on，限定location路径启用独立log_format，结合Content-Type过滤、base64编码及敏感字段脱敏，避免全站日志膨胀与安全风险。

nginx 中怎么在日志中精准记录客户端发起的请求体完整内容

要在 Nginx 日志中精准记录客户端请求体（$request_body）的完整内容，不能只靠简单开启变量——它默认为空，必须满足明确的读取与缓存条件，并配合路径隔离、大小控制和安全处理。核心是“让 Nginx 真正拿到 body 并稳定暴露给日志”。

确保 $request_body 可用的关键配置

该变量仅在 Nginx 已完整读取并暂存请求体后才非空。需同时满足：

设置 client_max_body_size（如 1m），避免因超限直接拒收
设置足够大的 client_body_buffer_size（如 128k），使常见 body 能驻留内存
启用 client_body_in_single_buffer on，防止 body 被拆分导致变量为空
若走代理（如 proxy_pass），必须保持 proxy_buffering on（默认即开启）
禁用文件落盘：确保 client_body_in_file_only off（默认值），否则 $request_body 为空字符串

按路径精准启用，避免全站日志膨胀

不要在 http 或 server 块全局启用，而是限定到具体接口路径：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

用 location = /api/v1/secure 精确匹配，或 location ~ ^/api/v1/secure 支持带参路径
在该 location 内定义独立 log_format，例如：
log_format secure_log '$remote_addr [$time_local] "$request" $status "$request_body"';
绑定专属日志文件：
access_log /var/log/nginx/secure-body.log secure_log;

处理大 body 和边界情况

当请求体超出缓冲区时，$request_body 会变为空。此时需结合其他手段：

检查 $request_length —— 它始终准确反映总请求字节数，可用于告警或过滤异常大包
若必须捕获超大 body，需启用 client_body_temp_path 并配合 Lua（OpenResty）读取临时文件，但生产环境慎用
对 GET、HEAD 等无 body 方法，$request_body 恒为空，建议在日志格式中加条件判断或直接过滤
注意 Content-Type，可加 if ($content_type ~ "application/json|application/x-www-form-urlencoded") { ... } 提前拦截无关类型