nginx默认不记录完整请求头，可通过log_format配合$http_*变量按需记录指定头，或借助headers-more-nginx-module模块一次性捕获全部原始请求头。
Nginx 默认不记录完整请求头，但可以通过组合 log_format、$http_* 变量和可选的 headers-more-nginx-module 实现。核心思路是：把需要的请求头显式映射为日志字段，或一次性捕获全部头内容。下面分两种实用方式说明。
方式一：按需记录指定请求头（推荐，轻量稳定）
这是最常用、无需额外编译模块的方法，适合记录 Trace-ID、X-Request-ID、Content-Type 等关键头。
- 在 http 块 中定义日志格式，用
$http_头名引用对应请求头（头名转小写，短横线换下划线）：log_format full_headers '$remote_addr - $remote_user [$time_local] "$request" '<br> ' $status $body_bytes_sent "$http_referer" "$http_user_agent" '<br> ' "$http_x_request_id" "$http_trace_id" "$http_content_type" "$http_appkey"';
- 在 server 或 location 块 中启用该格式：
access_log /var/log/nginx/access.log full_headers; - 注意：若客户端未发送某 header，对应字段值为空字符串，不会报错；变量名必须严格匹配，比如
X-B3-Traceid→$http_x_b3_traceid。
方式二：记录全部原始请求头（需第三方模块）
如果需要完整、动态地记录所有请求头（包括未知或临时添加的），需借助 headers-more-nginx-module 模块。
- 先下载并重新编译 Nginx，添加该模块：
./configure --add-module=/path/to/headers-more-nginx-module - 在 http 块中配置：
more_set_input_headers 'All-Request-Headers: $http_headers';<br> log_format all_headers '[%time_local] $remote_addr "$request" $status '<br> ' "$sent_http_content_type" "Input-Headers: $more_input_headers_all_request_headers"';
- 该方式会将所有请求头拼成一个字符串（如
"X-Forwarded-For: 1.2.3.4, X-Real-IP: 1.2.3.4"），适合审计或调试，但日志体积大、不易结构化解析。
补充要点：避免常见坑
无论哪种方式，以下细节直接影响是否生效：
- 请求体不等于请求头：`$request_body` 是 body 内容，不能用于记录 header；要记 header 必须用 `$http_*` 或 `more_set_input_headers`。
-
POST 请求体需缓冲支持：若同时记录 `$request_body`，请确保 `client_body_buffer_size` 足够（如
client_body_buffer_size 128k;），否则 body 可能为空。 -
配置后务必重载：修改完配置后执行
nginx -t测试语法，再运行nginx -s reload生效。 -
敏感头需脱敏：如 `Authorization`、`Cookie` 等不宜直接记录，可用 `map` 指令过滤或设为空：
map $http_authorization $safe_auth { default ""; ~*^Bearer.* ""; }，然后在日志中用$safe_auth。
不复杂但容易忽略。
