Apache用%{HEADER_NAME}i记录自定义请求头，需在LogFormat中显式声明，如%{X-Request-ID}i；Header不存在时输出“-”；代理场景下需确保上游正确传递且未被剥离。
Apache怎么用
记录自定义请求头
Apache 默认日志格式（
、
等）不包含任意 Request Header，必须显式用
语法提取。注意大小写不敏感，但连字符需原样写，比如
就得写成
，不能写成
—— 虽然 Apache 会识别，但可读性和维护性差。
实操建议：
在
中定义新格式，例如：
确保该格式名（如
）在
中被引用，否则不会生效
如果 Header 不存在，对应位置输出破折号
，不是空字符串，这点影响日志解析逻辑
为什么
总是空？排查代理链干扰
常见现象：Nginx 做前端代理并设置了
，但 Apache 日志里始终是
。根本原因不是 Apache 配置错，而是 Apache 默认不信任上游传递的 Header —— 它只从 TCP 连接的真实客户端 IP 解析
或
，而
是纯字符串提取，不校验来源。
关键点：
确认 Nginx 确实发出了该 Header：
测试是否能捕获
检查 Apache 是否启用了
（仅用于调试，非必需）；真正需要的是确保代理没被防火墙或中间设备剥离 Header
若用 CDN 或多层代理，Header 可能被重写或丢弃，优先用
（Cloudflare）或
并取最左 IP
+
联合过滤特定 Header 值
单纯记录所有值不够，常需只记满足条件的请求，比如只记录带
的请求。Apache 不支持日志行级 if 判断，但可用
先设环境变量，再在
中用条件日志。
Apache 2.4.62
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
下载
示例配置：
注意：
的正则匹配末尾加
防止
也被误匹配
表示仅当环境变量存在时才写入该日志，不影响其他日志流
环境变量名（
）不能含短横线，否则 Apache 启动失败
性能和兼容性要注意的三个细节
高频 Header 提取（如每秒数千请求）对性能有轻微影响，尤其配合正则或复杂条件时。不是瓶颈，但上线前应验证。
Apache 2.2 不支持
（环境变量）与
混用在同一个
字段中；2.4+ 支持，但字段顺序仍可能影响解析结果
Header 名含下划线（如
）会被 Apache 自动转为短横线（
），所以写
会失败，必须写
二进制或非 UTF-8 编码的 Header 值（少见）可能被截断或显示为乱码，Apache 日志本身不作编码转换
Header 名里的空格、括号、控制字符基本不可能合法出现在 HTTP 协议中，不用特殊处理；但别手误写成
却期望拿到解码后的值 —— 它就是原始字符串，包括
和分号。
%{HEADER_NAME}i%r%s%{Header-Name}iX-Forwarded-For%{X-Forwarded-For}i%{x-forwarded-for}iLogFormatLogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \"%{X-Request-ID}i\"" combined_with_xidcombined_with_xidCustomLog-%{X-Real-IP}iX-Real-IP-%a%h%{X-Real-IP}icurl -I -H "X-Real-IP: 192.168.1.100" http://your-apache-site/mod_headers%{True-Client-IP}i%{X-Forwarded-For}iSetEnvIfLogFormatX-Debug: trueSetEnvIfCustomLogSetEnvIfNoCase X-Debug "^true$" debug_request
LogFormat "%h %t \"%r\" %>s %{X-Request-ID}i" debuglog
CustomLog /var/log/apache2/debug.log debuglog env=debug_requestSetEnvIfNoCase$true-xenv=debug_requestdebug_request%{VAR}e%{HEADER}iLogFormatX_API_KeyX-API-Key%{X_API_Key}i%{X-API-Key}i%{Cookie}i%20