WebSocket连接失败解决方案(前后端联调场景)

问题现象:

• 使用 Apifox 等接口测试工具可正常建立 WebSocket 连接
• 前端代码发起 WebSocket 连接请求失败

解决方案:

在前端的 WebSocket 连接地址中加入项目上下文路径。

错误示例: ws://localhost:80/webSocket/1

正确格式: ws://localhost:80/{项目名称}/webSocket/1 (请将 {项目名称} 替换为实际部署的上下文路径)

然后确保后端 WebSocket 接口路径同样包含项目上下文路径，保持前后端路径一致性。

如果还解决不了的并且搜索了很多解决方案都未能解决的，请检查是否是后端版本兼容性的问题！
 

• Spring Boot 3.x 及以上版本 需使用 jakarta.websocket 相关依赖包
• Spring Boot 2.x 及以下版本 需使用 javax.websocket 相关依赖包