钟意博客
·
Spring WebSocket 错误
内容提要
本文讨论了在使用Spring MVC和WebSocket时可能遇到的握手失败、路由无效、API弃用及依赖冲突等问题，并提供了解决方案，如显式注入JSR-356容器、使用Reactor Netty客户端、确保配置类正确和统一依赖版本。此外，还列出了一些常见错误及其排查方法。
关键要点
-
JSR-356 容器握手失败的原因是 Spring MVC 默认使用的 StandardWebSocketClient() 未指定底层 WebSocketContainer，导致握手不发起。
-
解决方案包括显式注入 JSR-356 容器或切换到 Reactor Netty 客户端。
-
路由未生效的原因可能是构造函数注入 List<ISocketHandler> 导致循环依赖，需确保配置类加上 @EnableWebSocket 注解。
-
API 弃用与签名变化方面，StandardWebSocketClient 使用 doHandshake(...) 而非 execute，需根据客户端类型进行修正。
-
依赖冲突的原因是 Spring Boot 3.x 使用 jakarta.websocket，而 2.x 使用 javax.websocket，需统一依赖版本。
-
其他常见错误包括循环依赖、无效 JSON 和空指针异常，需根据具体情况进行排查和处理。
延伸解读
JSR-356 容器握手失败的原因
在使用 Spring MVC 和 WebSocket 时，JSR-356 容器握手失败的主要原因是未正确指定底层 WebSocketContainer。这可能导致客户端在握手阶段卡住或超时。开发者应注意显式注入 JSR-356 容器，或考虑切换到 Reactor Netty 客户端以避免此问题。
路由未生效的排查方法
如果配置了 WebSocketConfigurer 但路由未生效，可能是由于构造函数注入导致的循环依赖。确保配置类添加 @EnableWebSocket 注解，并检查日志中是否有映射信息，以便及时发现问题并进行修正。
API 弃用与版本兼容性
随着 Spring Framework 版本的更新，一些 API 被弃用，如 StandardWebSocketClient 的 doHandshake(...) 方法。开发者需关注这些变化，及时调整代码以使用推荐的 API，确保项目的长期兼容性。
依赖冲突的解决策略
在 Spring Boot 3.x 中，使用 jakarta.websocket 而非 javax.websocket，可能导致依赖冲突。开发者应统一依赖版本，并在必要时排除冲突项，以确保项目正常运行。
延伸问答
为什么在使用Spring MVC和WebSocket时会出现握手失败？
握手失败的原因是Spring MVC默认使用的StandardWebSocketClient未指定底层WebSocketContainer，导致握手不发起。
如何解决Spring WebSocket的握手失败问题？
可以显式注入JSR-356容器或切换到Reactor Netty客户端来解决握手失败问题。
路由未生效的原因是什么？
路由未生效可能是由于构造函数注入List<ISocketHandler>导致循环依赖，或者未加@EnableWebSocket注解。
Spring WebSocket中API弃用的常见问题有哪些？
常见问题包括StandardWebSocketClient使用doHandshake(...)而非execute，以及doHandshake自6.0起被弃用。
如何处理Spring Boot中的依赖冲突？
需要统一依赖版本，并确保与Spring Boot主版本匹配，必要时排除冲突项。
在Spring WebSocket中，如何排查常见错误？
可以根据错误类型进行排查，例如使用@Lazy解决循环依赖，确保JSON格式正确，处理空指针异常等。
