apache代理websocket连通性需分层验证：先确认模块启用（proxy_wstunnel等）和proxypass/ws://配置正确，再通过浏览器devtools查ws连接状态码（101=握手成功，502=后端不可达，400=upgrade/connection头未透传），最后用tcpdump或curl模拟验证http升级头是否正常转发。

测试 apache 代理 websocket 是否连通，关键不是跑个命令就完事，而是分层验证：先看代理配置是否生效，再确认握手能否成功，最后检查长连接是否稳定。浏览器控制台和后端日志是最直接的判断依据。

用浏览器开发者工具快速验证握手

打开前端页面后，在浏览器 DevTools 的 Network 面板中筛选 WS（或 WebSocket），找到目标连接：

• 状态码显示 101 Switching Protocols → 握手成功，Apache 已将 Upgrade 请求透传给后端
• 状态码是 502 Bad Gateway → 后端地址不可达、服务未启动，或 mod_proxy_wstunnel 未启用
• 状态码是 400 Bad Request 或连接瞬间关闭 → Upgrade 和 Connection 头未透传，检查 RequestHeader set 配置是否生效
• 无 WS 条目、只看到 pending XHR/polling → 客户端 fallback 到轮询，WebSocket 升级被阻断

检查 Apache 模块与配置是否就位

登录 Apache 容器或服务器，执行以下命令逐项确认：

Apache Superset Dashboard and SQL Exploration Skill

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

下载

• 运行 httpd -M | grep -E "(proxy|wstunnel|headers)"，确保输出包含：
  proxy_module (shared)、proxy_http_module (shared)、proxy_wstunnel_module (shared)、headers_module (shared)
• 检查虚拟主机配置中是否存在 ProxyPass /ws/ ws://...（注意是 ws://，不是 http://）
• 确认有 RequestHeader set Upgrade "websocket" 和 RequestHeader set Connection "upgrade"
• 查看 Timeout 和 ProxyTimeout 是否都设为 3600（不能只改一个）

抓包辅助定位中间环节问题

若浏览器层面看不出明显异常，可在 Apache 容器内抓包，确认请求是否真正发往后端：

• 在 Apache 容器中运行：tcpdump -i any -A port 8080（把 8080 替换为你的后端端口）
• 刷新页面，观察抓包内容中是否有 GET /ws/ HTTP/1.1 及 Upgrade: websocket 字段
• 如果没有，说明 Rewrite 或 ProxyPass 规则未命中；如果有但后端没响应，问题在容器网络或后端自身

用 curl 模拟简单握手（仅限调试）

curl 本身不支持 WebSocket，但可用来验证 HTTP 层升级头是否被正确接收：

• 执行：curl -i -H "Connection: upgrade" -H "Upgrade: websocket" -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" -H "Sec-WebSocket-Version: 13" http://your-domain/ws/
• 预期返回应含 HTTP/1.1 101 Switching Protocols 和 Upgrade: websocket
• 若返回 200 或 502，说明 Apache 未启用隧道模块或代理路径不匹配