SpringBoot集成Jetty WebSocket客户端注解不生效如何解决

• 缺少异步连接等待逻辑
  Jetty的client.connect()是异步非阻塞方法，调用后会立刻返回，不会等待握手完成。如果主线程执行完connect后没有阻塞等待直接结束运行，JVM退出后回调方法没有机会触发。
  解决方法：在connect代码后添加等待逻辑，可直接使用你现有代码中已经实现的awaitClose方法：

client.connect(socket,echoUri,requestws);
System.out.printf("Connecting to : %s%n",echoUri);
// 新增等待逻辑，最长等待10秒
socket.awaitClose(10, TimeUnit.SECONDS);

也可以获取connect返回的Future阻塞等待握手结果，方便排查异常：

Future<Session> connectFuture = client.connect(socket,echoUri,requestws);
// 阻塞3秒等待握手完成，异常会直接抛出
Session session = connectFuture.get(3, TimeUnit.SECONDS);

• 子协议不匹配导致握手失败
  你代码中设置了requestws.setSubProtocols("va-metadata")，要求服务端使用va-metadata子协议。如果服务端握手响应中没有返回该子协议，Jetty客户端会自动断开连接，不会触发@OnWebSocketConnect，只会触发@OnWebSocketClose回调。
  解决方法：

  1. 先注释掉该行代码，测试是否能正常触发回调
  2. 确认服务端确实支持va-metadata子协议，配置正确返回

• 依赖冲突导致注解不生效
  SpringBoot默认内置Tomcat容器，如果项目中同时存在Tomcat WebSocket和Jetty WebSocket的依赖，会导致类加载冲突，Jetty的注解无法被正确识别。
  解决方法：在build.gradle中排除Tomcat WebSocket相关依赖：

configurations {
    implementation.exclude group: 'org.apache.tomcat.embed', module: 'tomcat-embed-websocket'
}

同时确认Jetty版本和SpringBoot版本兼容：SpringBoot 2.x对应Jetty 9.4.x版本，SpringBoot 3.x需要升级到Jetty 11+版本。

• WebSocketClient生命周期管理错误
  如果连接逻辑写在一次性执行的方法中，方法执行完后WebSocketClient实例被GC回收，也会导致回调无法触发。
  解决方法：将WebSocketClient注册为Spring单例Bean，交由Spring管理生命周期：

@Bean
public WebSocketClient webSocketClient() throws Exception {
    WebSocketClient client = new WebSocketClient();
    client.start();
    return client;
}

@PreDestroy
public void stopWebSocketClient(@Autowired WebSocketClient client) throws Exception {
    client.stop();
}

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