Quarkus WebSocket连接1分钟后断开，如何维持连接及最佳实践？

内置机制说明 #

Quarkus 本身没有提供自动维持 WebSocket 连接活跃的内置机制，默认情况下若连接空闲超过设定时长（比如你遇到的1分钟），会被底层容器（如 Undertow）或反向代理主动断开。

是否需要实现心跳/Ping-Pong？ #

是的，必须通过 Ping/Pong 机制 来维持连接活跃，这是 WebSocket 协议原生支持的标准特性，无需用业务消息替代：

• 服务端可主动向客户端发送 Ping 帧，多数客户端会自动回复 Pong 帧
• 也可由客户端定期发送 Ping 帧，服务端响应 Pong
• 这种方式能避免连接因空闲被判定为失效而断开

最佳实践 #

• 优先用原生 Ping/Pong：不要自定义业务消息做心跳，原生帧更轻量且符合协议标准，减少不必要的业务逻辑开销
• 设置合理的心跳间隔：间隔时间要短于连接超时时间（比如设置为45秒，比1分钟超时更短）
• Quarkus 中的实现示例：
  在 WebSocket 端点类中，通过定时任务定期发送 Ping 帧：

  import io.quarkus.websockets.next.OnOpen;
  import io.quarkus.websockets.next.WebSocket;
  import io.quarkus.websockets.next.WebSocketConnection;
  import java.util.concurrent.ScheduledExecutorService;
  import java.util.concurrent.TimeUnit;
  import jakarta.inject.Inject;
  
  @WebSocket(path = "/ws")
  public class KeepAliveWebSocket {
  
      @Inject
      ScheduledExecutorService executor;
  
      @OnOpen
      public void onConnectionOpen(WebSocketConnection connection) {
          executor.scheduleAtFixedRate(() -> {
              if (connection.isOpen()) {
                  connection.sendPing(new byte[0]);
              }
          }, 0, 45, TimeUnit.SECONDS);
      }
  }
  

  浏览器端的 WebSocket 对象会自动响应 Ping 并返回 Pong，无需额外编写客户端逻辑
• 补充重连逻辑：即使配置了心跳，仍可能出现意外断开，客户端需实现自动重连逻辑，提升服务可靠性

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