在使用
WebSocket 注解方式启动时，常见的
报错通常与 Spring 容器管理机制、
WebSocket 生命周期以及依赖注入的冲突有关。以下是可能遇到的问题及其解决方案：
### 1.
WebSocket 实例由容器管理失败
当使用 `
@ServerEndpoint`
注解定义
WebSocket 处理类时，该类的实例由
Java WebSocket API 创建，而不是由 Spring 容器管理。这会导致 Spring 的依赖注入（如 `@Autowired`）失效，最终导致字段为 `null` [^2]。
#### 解决方案：
可以通过实现 `ApplicationContextAware` 接口手动获取 Spring 上下文，并通过上下文获取 Bean。例如，在 `My
WebsocketHandle` 类中，将自身设为静态变量以供访问，并通过同步方法确保线程安全地初始化依赖对象：
```
java
@ServerEndpoint("/ws")
@Component
public class My
WebsocketHandle implements ApplicationContextAware {
private static ApplicationContext applicationContext;
private
WebsocketAdapter
websocketAdapter;
@Override
public void setApplicationContext(ApplicationContext ctx) throws BeansException {
applicationContext = ctx;
}
private void init() {
if (
websocketAdapter == null) {
synchronized (My
WebsocketHandle.class) {
if (
websocketAdapter == null) {
websocketAdapter = applicationContext.getBean(
WebsocketAdapter.class);
}
}
}
}
}
```
这种方式可以确保即使
WebSocket 实例不由 Spring 管理，也能正确获取到 Spring Bean [^1]。
---
### 2. 缺少必要的依赖配置
如果项目中没有引入 Spring Boot 提供的
WebSocket 支持，也可能导致
WebSocket 启动失败或
无法正常工作。
#### 解决方案：
确保在 `pom.xml` 中添加了以下依赖：
```xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-
websocket</artifactId>
</dependency>
```
此外，还需要启用
WebSocket 配置，可以在配置类中添加 `@Enable
WebSocket` 或 `@Enable
WebSocketMessageBroker`
注解来激活
WebSocket 功能 [^3]。
---
### 3.
WebSocket 生命周期与 Spring 单例模式的冲突
WebSocket 是基于长
连接的协议，每个
连接都会创建一个新的处理实例，而 Spring 默认的 Bean 作用域是单例（Singleton）。这种不匹配可能导致注入失败或状态混乱。
#### 解决方案：
- **使用 ThreadLocal 存储
连接信息**：由于每个
WebSocket 连接都是独立的，可以使用 `ThreadLocal` 来存储每个
连接的状态信息，避免多个
连接共享相同的数据。
- **自定义
WebSocket 配置类**：通过注册 `
ServerEndpointExporter` Bean，确保
WebSocket 端点能够正确地与 Spring 容器集成：
```
java
@Configuration
@Enable
WebSocket
public class
WebSocketConfig {
@Bean
public
ServerEndpointExporter
serverEndpointExporter() {
return new
ServerEndpointExporter();
}
}
```
这样可以确保
WebSocket 端点被 Spring 正确管理，并支持注入 Spring Bean [^2]。
---
### 4. 检查
WebSocket 路径配置
WebSocket 路径配置错误也可能导致
连接失败。确保 `
@ServerEndpoint`
注解中的路径与客户端请求的路径一致，并且服务器端已正确部署。
#### 示例代码：
```
java
@ServerEndpoint("/ws")
@Component
public class My
WebsocketHandle {
// ...
}
```
客户端应使用如下 URL 建立
连接：
```
ws://yourdomain.com/yourapp/ws
```
---
### 5. 日志与异常排查
如果上述步骤仍然
无法解决问题，建议检查日志输出，特别是 Tomcat 或 Jetty 等嵌入式服务器的日志。常见的错误包括：
- `ClassNotFoundException` 或 `NoClassDefFoundError`：表示缺少相关类库。
- `IllegalStateException`：可能表示
WebSocket 已被多次注册或配置冲突。
- `NullPointerException`：通常是由于依赖未正确注入导致。
---
###
本文介绍了解决WebSocket连接中出现404错误的方法，主要原因是未正确配置@Component注解和ServerEndpointExporter Bean，通过添加这两个配置可以有效解决WebSocket连接问题。
扫一扫
1553
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
