ProxyPassReverse 对 WebSocket 无效，因其仅重写 HTTP 重定向头，而 WebSocket 依赖 Upgrade/Connection 头切换协议；真正关键的是启用 mod_proxy_wstunnel、使用 ws:// 协议前缀的 ProxyPass，并通过 RewriteRule 显式匹配并代理升级请求。
proxypassreverse 本身不支持 websocket 协议，它只处理 http 响应头中的 location、content-location 和 uri 重写，而 websocket 连接建立依赖于 upgrade: websocket 和 connection: upgrade 头，并不产生 301/302 重定向响应。因此，对 websocket 路径配置 proxypassreverse 是无效且无意义的——它不会修正 sec-websocket-accept 或 sec-websocket-location，也不会影响连接建立。
真正起作用的是 ProxyPass + RewriteRule + 模块启用
要让 Apache 正确代理 WebSocket 请求（如 /ws/ 或 /socket.io/），关键不在 ProxyPassReverse，而在以下三点：
- 启用 mod_proxy_wstunnel：Apache 2.4.5+ 必须加载该模块，否则 ws:// 目标会被拒绝或降级为普通 HTTP
-
ProxyPass 使用小写 ws:// 或 wss:// 协议前缀：例如
ProxyPass /ws/ ws://backend:8080/ws/，协议必须小写，路径末尾斜杠必须与后端严格一致 - 显式保留 Upgrade 和 Connection 头：仅靠 ProxyPass 不够，需配合 RewriteRule 捕获升级请求
标准 WebSocket 代理配置示例
假设前端访问 https://example.com/ws/chat，后端运行在 ws://127.0.0.1:8080/ws/chat：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so
<p><VirtualHost *:443>
ServerName example.com
SSLEngine on</p><h1>... SSL 证书配置省略</h1><pre class='brush:php;toolbar:false;'># 启用重写引擎并匹配 WebSocket 升级请求
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteCond %{HTTP:Connection} =upgrade [NC]
RewriteRule /ws/(.*) ws://127.0.0.1:8080/ws/$1 [P,L]
# 同时配置 ProxyPass（可选但推荐，用于非 Upgrade 场景如 socket.io 的 HTTP fallback）
ProxyPass /ws/ ws://127.0.0.1:8080/ws/
ProxyPassReverse /ws/ http://127.0.0.1:8080/ws/ <!-- 此行仅对 HTTP fallback 有效，对纯 ws 升级无作用 -->
# 确保 Host、X-Forwarded-* 等头透传
ProxyPreserveHost On
RequestHeader set X-Forwarded-Proto "https"</VirtualHost>
为什么 ProxyPassReverse 对 /ws/ 路径写成 http:// 也没错
因为 ProxyPassReverse 只改 Location 头，而后端 WebSocket 服务（如 Socket.IO）在收到 Upgrade 请求时根本不会返回 302；它直接切换协议。所以即使你写成 http://，也不会出错——它只是个“占位”配置，实际不生效。重点仍是 RewriteRule + [P] 标志触发隧道代理。
常见踩坑点
- 路径末尾斜杠不一致：比如前端请求
/ws，但 ProxyPass 写成ProxyPass /ws ws://...（缺 /），会导致 Sec-WebSocket-Location 错误，浏览器拒绝连接 - 没启用 mod_proxy_wstunnel：Apache 日志报错
Invalid URL in ProxyPass或连接被重置 - SSL 终止位置错误：若用 WSS，Apache 必须终止 TLS（即配了证书），不能把加密流量直传给后端 ws://
- 后端未允许跨域或未启用 websocket transport：如 Socket.IO 需设
transports: ['websocket']且cors: { origin: true }
