Apache mod_headers设置在ProxyPass时未传递至Tomcat的问题排查

我太懂这种头疼的情况了——明明在Apache里看到Upgrade头已经设置，但后端Tomcat就是收不到。这其实是Apache代理WebSocket时的常见配置误区，咱们一步步来搞定它：

核心原因分析 #

你用mod_headers设置的Upgrade头没传到Tomcat，大概率是这两个问题：

1. Apache的ProxyPass在处理WebSocket请求时，默认不会自动传递Upgrade和Connection这类“升级”相关的头；
2. 你可能没启用专门处理WebSocket代理的mod_proxy_wstunnel模块，导致Apache没法正确识别并转发WebSocket请求。

分步解决方案 #

1. 先启用必需的Apache模块 #

确保你的Apache加载了以下模块（如果是Debian/Ubuntu系，用a2enmod命令；RHEL/CentOS或手动配置的话，在httpd.conf里加LoadModule）：

a2enmod proxy proxy_http proxy_wstunnel headers

然后重启Apache：systemctl restart apache2（或对应系统的重启命令）

2. 调整VirtualHost的代理配置 #

别再单独用mod_headers硬设Upgrade头了，咱们结合WebSocket的代理规则来配置，确保头信息正确传递：

<VirtualHost *:80>
    ServerName your-domain.com  # 替换成你的域名或IP

    # 普通HTTP请求的转发规则
    ProxyPass / http://192.168.1.77:80/
    ProxyPassReverse / http://192.168.1.77:80/

    # WebSocket请求的专属代理规则（假设你的WebSocket端点是/ws，可根据实际修改）
    ProxyPass /ws ws://192.168.1.77:80/ws
    ProxyPassReverse /ws ws://192.168.1.77:80/ws

    # 仅当客户端发送Upgrade请求时，才把头传递给Tomcat
    RequestHeader set Upgrade "%{HTTP:Upgrade}e" env=HTTP_UPGRADE
    RequestHeader set Connection "upgrade" env=HTTP_UPGRADE
</VirtualHost>

这里的关键是：

• 用ws://协议来代理WebSocket请求，让Apache知道这是WebSocket流量；
• 通过env=HTTP_UPGRADE条件判断，只在客户端确实发起WebSocket升级请求时，才设置并传递Upgrade和Connection头，避免干扰普通HTTP请求；
• %{HTTP:Upgrade}e是直接读取客户端发送的原始Upgrade头值，而不是硬编码，更灵活可靠。

3. 确认Tomcat的WebSocket支持 #

Tomcat 8.5.x默认是支持WebSocket的，但可以检查下server.xml里的Connector配置，确保允许Upgrade协议：

<Connector port="80" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           upgradeProtocol="org.apache.coyote.http11.upgrade.UpgradeProtocol"/>

如果没加upgradeProtocol这一行，加上后重启Tomcat即可。

4. 验证配置是否生效 #

用curl测试WebSocket连接，看Tomcat是否能收到Upgrade头：

curl -i -N -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Host: your-domain.com" -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" -H "Sec-WebSocket-Version: 13" http://your-domain.com/ws

然后查看Tomcat的access_log，如果日志里能看到Upgrade: websocket的记录，就说明头已经成功传递了。

常见坑点排查 #

• 如果还是不行，检查Apache的mod_security（如果启用了），看是否有规则过滤了Upgrade头；
• 确保RequestHeader配置放在ProxyPass之前，否则可能不生效；
• 确认你的WebSocket端点路径和ProxyPass的路径完全匹配，别出现路径不一致的情况。

内容的提问来源于stack exchange，提问作者Mark Nenadov