Apache不生成代理状态码，而是通过响应头透传（如X-Backend-Status）记录后端真实状态码、业务错误码及耗时等，并用%{X-Backend-Status}o等语法在mod_log_config中记录，结合%D、%>s等指标定位问题环节。

Apache 本身不生成“代理状态码”——它只记录自己返回给客户端的最终响应状态码（如 %>s），而不会直接记录后端（如 Java 应用）返回的原始状态码。所谓“捕获代理状态码详细数据”，实际是指在反向代理场景下，把后端服务的真实响应状态、耗时、错误标识等关键上下文，通过响应头透传回 Apache，并由 mod_log_config 记录下来。

确认代理链中状态信息可被透传

Apache 的 mod_proxy 默认不保留后端响应头中的自定义字段。要让 Java 后端的状态线索（如真实 HTTP 状态、业务错误码、重试次数）进入 Apache 日志，需确保：

• Java 应用在响应中明确设置透传 Header，例如：
  response.setHeader("X-Backend-Status", String.valueOf(httpStatus));
response.setHeader("X-Biz-Code", "USER_NOT_FOUND");
• Apache 配置中启用 mod_headers（用于调试或增强日志），并确保未用 Header unset 或 Header always set 覆盖掉这些字段
• 若使用 ProxyPassReverse，它仅改写 Location 等特定响应头，不影响自定义 Header，因此无需额外配置即可透传

用 %{}o 记录后端返回的响应头字段

mod_log_config 支持用 %{HeaderName}o 语法读取**输出响应头（output header）**，这正是获取后端状态的关键。例如：

• %{X-Backend-Status}o → 记录 Java 返回的原始 HTTP 状态码（如 500、422）
• %{X-Biz-Code}o → 记录业务自定义错误码
• %{X-Response-Time}o → 若后端主动写入处理耗时（单位 ms），可与 Apache 自身的 %D 对比分析瓶颈

示例 LogFormat：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

LogFormat "%h %t \"%r\" %>s %b %{X-Backend-Status}o %{X-Biz-Code}o %D \"%{User-Agent}i\"" proxy_detailed

再通过 CustomLog /var/log/apache2/proxy_detail.log proxy_detailed 启用。

补充关键指标提升排查能力

单靠后端状态码还不够，需结合请求生命周期指标定位问题环节：

• %D：Apache 接收请求到发送完响应的总耗时（微秒），反映整体代理延迟
• %{X-Forwarded-For}i：真实客户端 IP，避免日志里全是 127.0.0.1
• %{Referer}i 和 %{User-Agent}i：辅助判断是否为爬虫或异常来源触发后端报错
• %>s 与 %{X-Backend-Status}o 对比：若前者是 502/503/504，后者为空或缺失，说明代理失败发生在连接后端前；若前者是 200 但后者是 500，说明后端出错但 Apache 未正确转发错误状态（需检查 ProxyBadHeader 或超时设置）

验证与调试建议

上线前务必验证字段是否真能采集到：

• 用 curl -I http://your-site/api/test 查看响应头是否含 X-Backend-Status 等字段
• 临时加一条测试日志：
  LogFormat "%h %t %{X-Backend-Status}o" debug_status
CustomLog /tmp/debug.log debug_status
  然后发起请求，检查 /tmp/debug.log 是否有值
• 若始终为空，检查 Java 应用是否在异步线程或过滤器异常中断后遗漏了 Header 设置