在 apache 中反向代理 spring boot websocket 服务，核心在于配置 mod_proxy 和 mod_proxy_wstunnel 模块，并在虚拟主机中使用 proxypass 和 proxypassreverse 指令将 websocket 连接请求转发到后端应用。必须显式设置 upgrade 和 connection 头部以支持协议切换，同时确保路径映射正确，避免静态资源与动态端点冲突。
如何配置 Apache 虚拟主机以支持 WebSocket 升级
要成功代理 WebSocket 连接，需要在 Apache 的虚拟主机配置中启用必要的代理模块，并针对 WebSocket 特定的 URL 路径（如 /ws）配置 ProxyPass 指令。关键在于使用 ws:// 或 wss:// 作为目标协议，并添加 upgrade 和 connection 头部的处理逻辑，以确保 HTTP 升级到 WebSocket 的过程不被拦截。
<virtualhost>
ServerName example.com
# 启用必要的模块
ProxyRequests Off
<proxy>
Require all granted
</proxy>
# 静态资源直接由 Apache 提供
Alias /static /var/www/html/static
<directory>
Require all granted
</directory>
# WebSocket 端点代理
ProxyPass /ws ws://localhost:8080/ws
ProxyPassReverse /ws ws://localhost:8080/ws
# 其他 HTTP 请求代理
ProxyPass / http://localhost:8080/
ProxyPassReverse / http://localhost:8080/
</virtualhost>
上述配置中，ProxyPass /ws ws://localhost:8080/ws 明确指定了 WebSocket 连接的转发规则。Apache 会自动处理 Upgrade 和 Connection 头部，但为了兼容性，有时需要手动确保这些头部被传递。如果后端 Spring Boot 应用运行在非标准端口，需替换 localhost:8080 为实际地址。此外，ProxyPassReverse 用于修正响应头中的 Location 字段，防止重定向错误。
如何处理并发连接与超时设置
WebSocket 是长连接，默认 Apache 的超时设置可能导致连接中断。需要调整 Timeout 和 KeepAlive 参数，并确保 mod_proxy 能够维持长时间的空闲连接。对于高并发场景，还需检查系统文件描述符限制和 Apache 的进程模型配置。
# 在 httpd.conf 或虚拟主机中调整超时 Timeout 600 KeepAlive On MaxKeepAliveRequests 100 KeepAliveTimeout 5 # 确保 mod_proxy 保持连接 ProxyPreserveHost On ProxyPass /ws ws://localhost:8080/ws ProxyPassReverse /ws ws://localhost:8080/ws
这里 Timeout 600 设置了较长的超时时间，适用于 WebSocket 长连接。如果使用的是 MPM Event 或 Worker 模型，需确认 MaxClients 或 ThreadsPerChild 足够大以容纳大量并发 WebSocket 连接。若遇到连接断开问题，可尝试在客户端或 Spring Boot 侧发送心跳包，并在 Apache 侧通过 ProxyPass 的 timeout 参数微调特定路径的超时行为。
当后端返回 404 时如何排查路径映射问题
如果访问 WebSocket 端点返回 404，通常是因为 Apache 的路径匹配优先级高于代理规则，或者静态资源目录覆盖了动态路径。例如，若存在 /ws 的物理目录，Apache 会优先返回该目录内容而非代理请求。解决方法是确保代理指令在静态资源指令之前，或使用更精确的正则表达式匹配路径。
# 调整顺序，确保代理优先
ProxyPass /ws ws://localhost:8080/ws
ProxyPassReverse /ws ws://localhost:8080/ws
# 静态资源放在后面
Alias /static /var/www/html/static
<directory>
Require all granted
</directory>
此配置中，ProxyPass 指令位于 Alias 之前，确保 /ws 路径被正确代理。若仍存在问题，可使用 LogLevel debug 查看 Apache 访问日志，确认请求是否到达代理模块。另外，检查 Spring Boot 应用的 @ServerEndpoint 或 WebSocketHandler 注册路径是否与 Apache 代理路径一致，避免因路径前缀不匹配导致 404。
