如何在Spring WebSocket中记录Ping/Pong消息？为何Pong日志未输出？

我想要检查并记录客户端与Spring WebSocket服务器之间的Ping/Pong交互。我尝试继承BinaryWebSocketHandler并添加以下方法：

@Override
protected void handlePongMessage(WebSocketSession session, PongMessage message) throws Exception {
    log.trace("RECEIVING PONG {} {}",message.getPayloadLength(), Utils.bytesToHex(message.getPayload().array()));
    super.handlePongMessage(session, message);
}

@Override
protected void handleBinaryMessage(WebSocketSession session, BinaryMessage message) throws Exception {
    log.trace("RECEIVING MSG {} {}",message.getPayloadLength(), Utils.bytesToHex(message.getPayload().array()));
}

目前能看到handleBinaryMessage的日志，但看不到Pong日志，想了解原因，以及是否可能Ping/Pong未启用？

可能的原因 #

• 日志级别过滤：你使用了log.trace()，若项目日志级别设置高于TRACE（比如DEBUG、INFO），这条日志会被直接过滤。可以临时将日志级别调整为TRACE，或者替换为log.debug()测试。
• Ping/Pong未启用或未触发：Spring WebSocket默认不会主动发送Ping帧，需显式配置心跳机制：
  若使用SockJS，可在配置中开启心跳：

  @Configuration
  @EnableWebSocket
  public class WebSocketConfig implements WebSocketConfigurer {
      @Override
      public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
          registry.addHandler(customBinaryWebSocketHandler(), "/ws")
                  .setAllowedOrigins("*")
                  // 每30秒发送一次Ping，90秒未收到Pong则断开连接
                  .withSockJS()
                  .setHeartbeatTime(30000);
      }
  
      @Bean
      public WebSocketHandler customBinaryWebSocketHandler() {
          return new YourCustomBinaryWebSocketHandler();
      }
  }
  

  若使用原生WebSocket，需通过WebSocketSession.sendPing()手动发送Ping帧，客户端才会回复Pong。
• 客户端未响应Pong：部分客户端实现可能不会自动回复Ping帧，需确认客户端WebSocket逻辑是否支持Ping/Pong响应。
• 消息被上层拦截：检查是否存在HandshakeInterceptor或WebSocketHandlerDecorator等拦截器提前处理了Pong消息，导致自定义的handlePongMessage未触发。

验证步骤 #

1. 调整日志级别至TRACE，排除日志过滤问题。
2. 配置并触发服务器主动发送Ping帧，观察客户端是否回复Pong。
3. 使用WebSocket调试工具（如wscat、浏览器控制台）手动发送Pong帧，验证服务器是否能打印日志，排查是客户端还是服务器配置问题。

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