Apache mod_log_config默认不支持%{HeaderName}o记录自定义响应头，因该语法未实现；推荐用mod_lua读取headers_out存入notes后以%{Var}n记录，或由Java应用层通过MDC/AccessLogValve注入日志上下文。
Apache 的 mod_log_config 默认不支持直接记录自定义响应头（如 X-Trace-ID、X-Process-Time），因为 %{HeaderName}o 语法在标准模块中未实现。想在 Apache 日志里看到这些 Java 后端写入的响应头，必须绕过这个限制——核心思路是：让响应头的值“变成 Apache 能识别的日志字段”，再通过日志格式输出。
为什么 %{X-My-Header}o 总是空或报错
Apache 2.4 及更早版本的 mod_log_config 没有为 %{}o 提供通用响应头读取能力。它只支持极少数内置响应相关变量（如 %>s、%D），但不包括任意 headers_out。即使 Java 应用已正确设置 response.setHeader("X-Trace-ID", "abc123")，在 LogFormat 中写 %{X-Trace-ID}o 也不会生效。
推荐方案：用 mod_lua 在响应后提取并记入 notes
这是最轻量、可靠且无需修改 Java 代码的方式（需 Apache 2.4+ 并启用 mod_lua）：
- 加载模块：
LoadModule lua_module modules/mod_lua.so - 添加钩子：
LuaHookLog /path/to/log_response.lua log_response - 在
log_response.lua中读取响应头并存入 notes：
r:note("X_Trace_ID", r.headers_out["X-Trace-ID"] or "-")
r:note("X_Process_Time", r.headers_out["X-Process-Time"] or "-")
end
然后在 LogFormat 中使用 %{X_Trace_ID}n 和 %{X_Process_Time}n（n 表示 notes 变量），例如：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
CustomLog logs/access_with_trace.log trace_log
更稳妥的做法：由 Java 应用主动注入日志上下文
把日志逻辑下沉到应用层，避免 Apache 层耦合。Spring Boot 常用方式如下：
- 在 Filter 或 Interceptor 中计算耗时、生成唯一 ID，并写入 MDC：
MDC.put("traceId", requestId) - 配置 Logback 或 Log4j2，在访问日志 Pattern 中包含
%X{traceId} - 或让 Tomcat 的
AccessLogValve直接输出 MDC 字段（需自定义 Valve 或用org.apache.catalina.valves.AccessLogValve扩展）
此时 Apache 只需记录基础请求信息（如 %{X-Forwarded-For}i、%D），关键业务字段由 Java 日志系统统一管理，可追溯、可过滤、可结构化。
不推荐的“伪方案”：SetEnvIfNoCase 匹配响应头
网上有建议用 SetEnvIfNoCase ^X-Trace-ID$ (.+) TRACE_ID=$1 再配合 %{TRACE_ID}e，但该指令实际只匹配请求头（headers_in），对响应头无效。实测中该配置不会捕获任何值，属于常见误解，应避免使用。
