apache不参与sec-websocket-protocol协商，仅需透传该头：启用proxy_wstunnel模块、用ws://前缀代理、禁用proxybadheader过滤、避免响应头篡改，并通过直连验证定位子协议失败根源。
apache 反向代理本身不参与 websocket 子协议（sec-websocket-protocol）的协商逻辑，它只负责透传请求与响应头。子协议失败的根本原因在服务端未正确响应或客户端传参不匹配，但 apache 配置不当会加剧问题——比如头被过滤、路径代理错误、或模块缺失导致握手根本无法抵达后端。
确认 Apache 没有拦截或改写子协议头
Apache 默认可能丢弃非常规请求头（如 Sec-WebSocket-Protocol），尤其当启用了 ProxyBadHeader Ignore（默认值）时。需显式允许该头部透传：
- 在虚拟主机或位置块中添加：
ProxyBadHeader Ignore→ 改为ProxyBadHeader Error或更稳妥地直接禁用过滤：ProxyBadHeader Start - 确保未启用
mod_headers的误删规则，例如RequestHeader unset Sec-WebSocket-Protocol这类配置必须移除 - 用
curl -v -H "Sec-WebSocket-Protocol: json-v1" -H "Upgrade: websocket" ...模拟握手，检查 Apache 日志是否记录该头到达代理层
确保 WebSocket 路径由 mod_proxy_wstunnel 代理，而非普通 HTTP 模块
子协议协商发生在 HTTP 升级阶段，若路径被 ProxyPass 指向 http:// 而非 ws://，Apache 会终止升级流程，导致服务端收不到 Sec-WebSocket-Protocol 请求头：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 必须使用
ws://或wss://协议前缀：例如ProxyPass /ws/ ws://localhost:8080/ws/ - 禁止混用：不能写成
ProxyPass /ws/ http://localhost:8080/ws/，否则握手被降级，子协议字段丢失 - 验证模块已启用：
a2enmod proxy_wstunnel，且未被其他模块（如mod_security）拦截升级请求
服务端响应必须原样返回子协议，Apache 不得修改响应头
浏览器严格校验服务端响应中的 Sec-WebSocket-Protocol 值是否与客户端请求完全一致（大小写、顺序、空格）。Apache 若做了响应头重写或压缩，可能破坏该字段：
- 禁用可能干扰响应头的模块，如
mod_deflate对 WebSocket 响应的误压缩（WebSocket 响应体为空，但头不可压缩） - 不要在配置中使用
Header set Sec-WebSocket-Protocol或类似指令，避免覆盖服务端真实响应 - 用浏览器开发者工具 Network 标签页查看实际响应头，确认
Sec-WebSocket-Protocol: json-v1完整存在且无拼写偏差
调试建议：绕过代理直连验证子协议逻辑
快速定位是 Apache 还是服务端的问题：
- 临时让客户端直连后端（如
new WebSocket('ws://localhost:8080/ws', ['json-v1'])），若成功 → 问题在代理链 - 若直连也失败，说明服务端未实现子协议协商（例如未调用
accept()时指定subprotocols参数） - Apache 侧可开启详细日志：
LogLevel proxy:trace5，观察日志中是否出现Subprotocol: json-v1相关记录
