Apache HTTP Server不原生支持WebSocket，需启用mod_proxy_wstunnel模块并配置ProxyPass/ws→ws://后端以透传Upgrade请求，同时禁用干扰模块、调优KeepAlive，并通过101响应和日志验证。
java中apache http server本身不原生支持websocket协议，它只是一个http/https反向代理或静态资源服务器。若需在基于apache的架构中使用websocket（如后端是spring boot、tomcat或jetty），关键不是让apache“处理”websocket，而是正确配置其作为反向代理时对websocket upgrade请求的透传支持。
确保启用mod_proxy_wstunnel模块
Apache从2.4.5版本起提供mod_proxy_wstunnel模块，专用于代理WebSocket的Upgrade: websocket请求。需确认该模块已启用：
- 检查
httpd.conf或apache2.conf中是否包含：LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so - 同时确保依赖模块已加载：
mod_proxy、mod_proxy_http - Linux发行版常用命令启用：
a2enmod proxy proxy_http proxy_wstunnel（Debian/Ubuntu）
正确配置ProxyPass以支持WebSocket Upgrade
仅用ProxyPass转发HTTP请求不足以支持WebSocket；必须显式声明WebSocket隧道规则。典型配置如下（假设后端WebSocket服务运行在localhost:8080/ws）：
ProxyRequests Off ProxyPreserveHost On <h1>先匹配WebSocket路径，走wstunnel</h1><p>ProxyPass /ws ws://localhost:8080/ws ProxyPassReverse /ws ws://localhost:8080/ws</p><h1>其余HTTP请求走普通代理</h1><p>ProxyPass / <a href="https://www.php.cn/link/d6686469a29701048799005b5ebb1529">https://www.php.cn/link/d6686469a29701048799005b5ebb1529</a> ProxyPassReverse / <a href="https://www.php.cn/link/d6686469a29701048799005b5ebb1529">https://www.php.cn/link/d6686469a29701048799005b5ebb1529</a>
注意：ws://（非http://）协议前缀会触发mod_proxy_wstunnel，自动处理Connection: Upgrade和Upgrade: websocket头。
避免常见代理拦截问题
某些Apache默认配置或安全模块可能干扰WebSocket握手。需检查并调整：
立即学习“Java免费学习笔记（深入）”；
- 禁用
mod_security对Upgrade头的误拦截（可临时关闭或添加规则放行） - 确认
KeepAlive开启，且KeepAliveTimeout足够长（建议≥60秒） - 避免在Location块中使用
ProxySet keepalive=on以外的冗余设置，易引发连接复用异常 - 若用SSL终止，确保
wss://请求被正确转为ws://（后端无需TLS），或使用wss://后端（需Apache 2.4.10+并配置SSL Proxy）
验证与调试技巧
配置生效后，可通过以下方式验证WebSocket连通性：
- 浏览器开发者工具Network标签下查看WS连接状态码应为
101 Switching Protocols - 用
curl -i -N -H "Upgrade: websocket" -H "Connection: Upgrade" http://your-domain/ws模拟握手，观察响应头 - Apache错误日志（
ErrorLog）中搜索WSTUNNEL或proxy_wstunnel关键词定位模块加载或转发问题 - 后端应用日志确认是否收到
Handshake及后续帧数据，排除应用层配置问题（如Spring的AllowedOrigins、CORS等）
