如何通过Apache mod_proxy保持后端WebSocket长连接的协议活跃？

本文共计617个文字，预计阅读时间需要3分钟。

Apache 本身不直接处理 WebSocket 心跳，关键在于确保连接不被中间设备（包括 Apache 本身）因空闲而断开。核心不是保持心跳，而是不让它断开——通过透传协议、延长超时、维持隧道语义来实现长连接的存活。

必须启用并确认mod_proxy_wstunnel模块

mod_proxy_http无法正确代理WebSocket帧流，只有mod_proxy_wstunnel能识别Upgrade握手并建立隧道。检查是否已加载：

• 运行httpd -M | grep -E "(proxy|wstunnel)"，输出中需包含proxy_wstunnel_module
• 若缺失，在httpd.conf或模块配置文件中添加：
  LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so
• 确保mod_proxy和mod_proxy_http也已启用（前者是基础依赖，后者被wstunnel内部调用）

ProxyPass必须使用ws://或wss://前缀

写成ProxyPass /ws/ http://backend:8080/ws/会导致Apache走HTTP代理流程，握手虽可能成功，但后续二进制帧会被截断或静默丢弃。