Apache不直接处理WebSocket心跳，保活关键在于透传协议、延长超时及维持隧道语义；必须启用mod_proxy_wstunnel模块，ProxyPass需用ws://或wss://前缀，严格匹配路径末尾/，并设置Timeout和ProxyTimeout为3600，禁用缓存与干扰行为，负载均衡时需sticky session绑定路由。

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代理流程，握手虽可能成功，但后续二进制帧会被截断或静默丢弃。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• 正确写法：
  ProxyPass /ws/ ws://127.0.0.1:8080/ws/
  ProxyPassReverse /ws/ ws://127.0.0.1:8080/ws/
• 路径末尾/必须严格一致，否则Sec-WebSocket-Location头重写错误，浏览器拒绝连接
• 若用WSS，前端必须是HTTPS站点，且Apache需配置SSL证书（不能只靠后端提供）

显式延长超时并禁用干扰行为

默认60秒Timeout会强制关闭空闲连接，这是长连接中断的最常见原因。

• 在虚拟主机内设置：
  Timeout 3600
  ProxyTimeout 3600
• 这两个值必须同时设——Timeout影响整体请求生命周期，ProxyTimeout控制代理连接的socket级超时
• 禁用buffering与cache：
  SetEnv nokeepalive 1（不推荐）或更稳妥地：确保后端主动发送ping/pong，Apache不做任何body缓存

负载均衡场景下绑定会话路由

多个后端节点时，一次WebSocket连接必须始终落在同一实例上，否则状态丢失、认证失效。

• 启用mod_proxy_balancer，定义balancer组
• 在ProxyPass中加入stickysession=routeid
• 后端服务需在握手响应中注入route标识，例如：
  Set-Cookie: route=ws-node-1; Path=/ws/
  或返回自定义header：
  X-Route-ID: ws-node-1