Apache虚拟主机中记录特定Request Header需在内用%{Header-Name}i语法定义LogFormat（如%{X-Request-ID}i），配合CustomLog实现站点级隔离；Header不存在时输出“-”；须确保上游未剥离该Header，并可通过Header set回显验证传递链。
在 apache 虚拟主机中记录请求报文里的特定自定义 header（如 x-request-id、x-forwarded-for、x-debug 等），核心是用 %{header-name}i 语法配合 logformat 和 customlog，且必须把相关指令写在 <virtualhost></virtualhost> 块内——否则无法实现站点级隔离与审计。
确认 mod_log_config 已启用并作用于当前虚拟主机
确保 Apache 加载了该模块：
- 检查配置中存在
LoadModule log_config_module modules/mod_log_config.so - 运行
apachectl -M | grep log_config确认已启用 - 不要在全局配置里写
CustomLog，否则所有站点日志会混在一起
在 VirtualHost 内定义带自定义 Header 的日志格式
直接在 <virtualhost></virtualhost> 块中声明格式，例如记录真实 IP 和追踪 ID：
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \"%{X-Request-ID}i\" \"%{X-Forwarded-For}i\"" vhost_audit- 注意：
%{X-Request-ID}i中的i表示 input（请求头），大小写不敏感但连字符必须原样保留 - 若 Header 不存在，对应位置输出
-，不是空字符串，这对日志解析很关键
绑定日志路径并启用条件审计（可选）
只对含特定 Header 的请求做详细审计，避免日志膨胀：
- 用
SetEnvIfNoCase标记目标请求：SetEnvIfNoCase X-Audit "^true$" audit_request - 再定义精简格式：
LogFormat "%t %h \"%r\" %{X-Request-ID}i %{X-User}i" audit_only - 最后指定条件写入：
CustomLog /var/log/apache2/audit.log audit_only env=audit_request
验证 Header 是否被正确传递和识别
常见失败不是配置错，而是 Header 在到达 Apache 前已被剥离或改名：
- 用
curl -H "X-Request-ID: abc123" http://yoursite/测试能否捕获 - 若上游是 Nginx 或 CDN，确认它未过滤或重命名该 Header（如 Cloudflare 默认删
X-开头私有头） - 可在同一
<virtualhost></virtualhost>中临时加Header set X-Debug-Seen "%{X-Request-ID}i"，再用浏览器看响应头是否回显，快速定位传递断点
