apache本身不处理websocket协议升级，仅透传upgrade/connection等关键头；需启用proxy_wstunnel模块、用ws://前缀代理、禁用头过滤、避免响应篡改，并同步超时设置以确保握手成功。

apache 本身不处理 websocket 协议升级逻辑，只负责透传 upgrade 流程所需的头部和连接。升级失败不是 apache “拒绝升级”，而是它默认不转发关键头、不启用隧道模块、或配置路径错误，导致握手请求根本没抵达后端服务。

确保 Upgrade 和 Connection 头被完整透传

WebSocket 握手依赖两个强制请求头：Upgrade: websocket 和 Connection: Upgrade。Apache 默认会剥离非常规头，必须显式保留：

• 在对应 <location></location> 或虚拟主机配置块中添加：
  ProxyPreserveHost On
RequestHeader set Upgrade "websocket"
RequestHeader set Connection "upgrade"
• 禁用头过滤：将 ProxyBadHeader Ignore 改为 ProxyBadHeader Start，避免 Sec-WebSocket-Protocol 等头被丢弃
• 检查是否有 RequestHeader unset Sec-WebSocket-Protocol 类规则，必须删除

用 ws:// 前缀启用 proxy_wstunnel 隧道代理

普通 ProxyPass（如 http://）会终止 HTTP 升级流程，必须改用 WebSocket 专用协议前缀：

Apache Superset Dashboard and SQL Exploration Skill

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

下载

• 正确写法：ProxyPass /ws/ ws://localhost:8080/ws/（开发环境）或 ProxyPass /ws/ ws://app-backend:8080/ws/（容器环境）
• 错误写法：ProxyPass /ws/ http://... —— 这会让 Apache 当作普通 HTTP 转发，Sec-WebSocket-Protocol 等头全部丢失
• 确认已启用模块：a2enmod proxy_wstunnel，且 apachectl -M | grep wstunnel 输出可见该模块

防止响应头被篡改或压缩

浏览器严格校验服务端返回的 Sec-WebSocket-Protocol 值是否与客户端请求完全一致（大小写、顺序、空格）。Apache 若干预响应，会导致校验失败：

• 禁用 mod_deflate 对 WebSocket 响应的误压缩（WebSocket 响应体为空，但头不可压缩）
• 移除所有 Header set Sec-WebSocket-Protocol 或 Header edit 类指令
• 用浏览器 Network 面板检查实际响应头，确认 Sec-WebSocket-Protocol: json-v1 完整存在、无拼写偏差

同步超时设置并绕过代理快速定位问题

连接挂起或 502 错误常因超时错位引起；而直连后端能快速区分是 Apache 还是服务端的问题：

• 延长代理层超时：ProxyTimeout 3600 + Timeout 3600，并与后端（如 Spring Boot 的 server.tomcat.connection-timeout）对齐
• 临时让前端直连后端地址：new WebSocket('ws://localhost:8080/ws', ['json-v1'])
• 若直连成功 → 问题在 Apache 配置；若仍失败 → 检查服务端子协议支持逻辑或 CORS 配置