WebSocket连接异常：握手返回404错误，请求排查故障原因

• 服务端WebSocket路由配置变更：之前能正常连接说明原路由配置是有效的，大概率是后续部署时修改了路由规则、调整了端点路径，或是框架更新后路由匹配逻辑发生变化，导致客户端请求的路径找不到对应的WebSocket处理程序。
• 服务端部署/重启异常：服务重启后可能未正确加载WebSocket服务模块，或是进程启动失败、端口监听异常，使得请求无法被WebSocket服务接收处理。
• 反向代理/负载均衡配置问题：如果前端请求经过Nginx等代理服务，可能是代理规则被修改，没有正确将WebSocket握手请求转发到后端服务，或是代理的路径重写、缓存机制导致请求路径出错。
• 客户端请求路径错误：客户端部署时可能配置错了服务地址、WebSocket端点路径，导致请求的地址与服务端实际提供的WebSocket路径不匹配。
• 权限或防火墙限制：新增的防火墙、安全组规则可能阻断了WebSocket握手请求；或是服务端给WebSocket路径添加了权限校验，未通过校验时部分服务会返回404来隐藏真实的权限问题。
• 资源路径冲突：服务端新增的HTTP接口路径与WebSocket端点重合，导致请求被HTTP接口处理而非WebSocket服务，进而返回404。

内容的提问来源于stack exchange，提问作者Rashid Khan