为何Java WebSocket可发送带负载PING消息却无法接收？

客户端发送PONG的API #

public void sendPong(String message) throws IOException {
    ByteBuffer buffer = ByteBuffer.wrap(message.getBytes());
    this.session.getAsyncRemote().sendPong(buffer);
}

服务端接收PONG的API #

@OnMessage
public void onMessage(PongMessage message, Session session) throws IOException {
    LOGGER.log(Level.INFO, "Received PONG message: " + new String(message.getApplicationData().array()));
}

客户端发送PING的API #

public void sendPing(String message) throws IOException {
    ByteBuffer buffer = ByteBuffer.wrap(message.getBytes());
    this.session.getAsyncRemote().sendPing(buffer);
}

服务端API没有用于接收PING消息的方法。

疑问：为何Java WebSocket客户端可以发送带有负载的PING消息，但服务端却无法接收PING消息？ #

原因解析 #

这是遵循WebSocket协议（RFC 6455）规范，同时也是Java WebSocket API（JSR 356）的设计约定：

1. 协议层面的职责定义

   • PING帧的核心定位是心跳检测，协议明确要求：当端点收到PING帧时，必须自动回复对应PONG帧（如果PING带有负载，PONG需携带相同负载），这个回复过程由WebSocket底层实现自动完成，不需要业务代码干预。
   • PONG帧除了作为PING的响应，也支持主动发送用于业务状态同步，因此允许上层代码监听处理PONG帧的自定义负载。

2. Java API的设计逻辑

   • Java WebSocket API将PING帧的处理完全交给底层容器（如Tomcat、Jetty的WebSocket实现），上层业务代码无法直接接收PING帧，避免业务逻辑干扰心跳机制的自动执行，保证连接检测的可靠性。
   • 针对PONG帧提供监听接口，是因为它可能承载业务自定义的状态信息，需要业务代码按需处理。

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