如何排查 Apache 反向代理中出现的请求头部丢失-Apache-PHP中文网

apache反向代理本身不丢header，所谓“丢失”实为链路中某层未透传、过滤或解析失败；需分四步排查：前置代理下划线配置、apache接收验证、proxypass透传设置、后端异步上下文继承。

如何排查 apache 反向代理中出现的请求头部丢失

Apache 反向代理本身不主动丢 header，请求头“丢失”其实是链路中某一层未透传、被过滤或解析失败。排查要分段验证：从客户端出发，逐层检查 Nginx/HAProxy（如有）、Apache 配置、后端应用接收逻辑，最终定位断点。

很多团队用 auth_token、x_api_key 这类带下划线的 header，但 Apache 默认不识别它们——这不是 bug，而是 RFC 兼容性设计。Nginx 也有同样行为，若它在 Apache 前面，问题更隐蔽。

检查 Apache 所在服务器上是否有前置代理（如 Nginx），并在其 http 或 server 块中确认是否启用：underscores_in_headers on;
Apache 自身虽无该指令，但若用 mod_proxy 转发，需确保后端服务（如 Tomcat）也接受小写形式的 header；Java 中常需用 request.getHeader("authorization") 而非 getHeader("Authorization")
临时改用短横线命名测试，比如把 auth_token 改成 auth-token，看是否立即恢复

不能只信后端日志，得先确认 Apache 有没有接收到。最直接的办法是开启访问日志记录原始请求头。

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

下载

在 Apache 配置中添加自定义日志格式，例如：
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" \"%{Authorization}i\" \"%{X-Forwarded-For}i\" \"%{auth_token}i\"" proxy_debug
将该格式应用到虚拟主机：
CustomLog logs/proxy-debug.log proxy_debug
重启 Apache，发起一次带目标 header 的请求，查看日志中对应字段是否为空

即使 Apache 收到了 header，用 ProxyPass 转发给后端时，若没显式设置，它默认不会把所有 header 都带上。

在 ProxyPass 所在的 <location></location> 或 <virtualhost></virtualhost> 中，添加透传指令：
RequestHeader set Authorization %{HTTP:Authorization}e
或更通用的写法：
RequestHeader set X-Auth-Token %{HTTP:X-Auth-Token}e
若 header 名含下划线且来自前置代理，Apache 内部已转为小写变量（如 %{HTTP:auth_token}e），需按小写名引用
禁用可能覆盖 header 的 RewriteRule 或 SetEnvIf 指令，尤其避免 unset 类操作

如果后端是 Java（Spring Boot）、Node.js 等支持异步的运行时，header 丢失可能发生在业务代码里，而非网络层。

Spring 中若用了 CompletableFuture 或自定义线程池，RequestContextHolder 默认不跨线程，需手动传递或提取值入参
检查是否依赖 ThreadLocal 获取 header，异步调用前未做上下文快照
最稳妥方式：在 controller 层就取出关键 header 值（如 token、tenant-id），作为参数传给 service，不依赖后续线程中的 request 对象