java.lang.illegalstateexception: javax.websocket.server.servercontainer not available

This exception occurs when attempting to use the WebSocket API in Java and the server container is not available. This could happen if the WebSocket implementation is not properly initialized or if the container is not properly configured. To resolve this issue, ensure that the WebSocket implementation is correctly initialized and the container is configured properly. Check if the server container is properly installed and running. If not, install and configure the container properly to avoid this exception.

### 解决方案 在 Java WebSocket 中出现 `java.lang.IllegalStateException: javax.websocket.server.ServerContainer not available` 错误时，通常是因为配置或环境问题导致的。以下是几种常见的解决方案： 1. **注释掉 WebSocket 相关的注解** 一种简单但不推荐的方式是直接注释掉与 WebSocket 配置相关的注解，例如 `@EnableWebSocket` 和 `@Configuration`[^1]。这种方式虽然可以避免错误，但会禁用 WebSocket 功能。 2. **移除 ServerEndpointExporter 的定义** 如果不需要使用 Spring 的 `ServerEndpointExporter`，可以直接从配置类中移除其 Bean 定义。具体操作为注释掉或删除以下代码片段[^2]： ```java @Bean public ServerEndpointExporter serverEndpointExporter() { return new ServerEndpointExporter(); } ``` 3. **使用环境激活策略** 更优雅的解决方案是通过 Spring 的 `@Profile` 注解限制 `ServerEndpointExporter` 的加载范围。例如，仅在开发环境（`dev`）或测试环境（`test`）中加载 WebSocket 配置，在生产环境中禁用它。示例代码如下[^3]： ```java @Configuration //@EnableWebSocket public class WebSocketConfig { @Bean @Profile({"dev", "test"}) public ServerEndpointExporter serverEndpointExporter() { return new ServerEndpointExporter(); } } ``` 4. **检查嵌入式 Tomcat 的版本** 确保使用的 Spring Boot 版本和嵌入式 Tomcat 版本支持 WebSocket 功能。如果 Tomcat 版本过低，可能会导致 `ServerContainer` 不可用的问题。可以通过升级 Spring Boot 或显式指定 Tomcat 版本来解决此问题。 5. **避免与其他 WebSocket 实现冲突** 如果项目中同时引入了多个 WebSocket 实现（例如 Jetty 和 Tomcat），可能会导致冲突。建议检查项目的依赖树，确保没有重复或冲突的依赖项。 6. **手动注册 WebSocket Endpoint** 如果仍然无法解决问题，可以尝试手动注册 WebSocket Endpoint，而不是依赖 `ServerEndpointExporter` 自动扫描。示例代码如下： ```java @Configuration public class WebSocketConfig { @Bean public ServletListenerRegistrationBean<TomcatWebSocketEventListener> tomcatWebSocketEventListener() { return new ServletListenerRegistrationBean<>(new TomcatWebSocketEventListener()); } private static class TomcatWebSocketEventListener extends ServletContextAttributeListener { @Override public void attributeAdded(ServletContextAttributeEvent event) { if ("javax.websocket.server.ServerContainer".equals(event.getName())) { ServerContainer container = (ServerContainer) event.getValue(); try { container.addEndpoint(MyWebSocketEndpoint.class); } catch (DeploymentException e) { throw new RuntimeException(e); } } } } } ``` ### 注意事项 - 在生产环境中，尽量避免启用 WebSocket 功能，除非确实需要。 - 如果使用的是第三方库（如 Undertow 或 Jetty），请确保其配置与 Spring Boot 的默认配置兼容。 - 如果以上方法均无效，可以尝试通过日志定位问题的具体原因，并根据实际情况调整配置。