WebSocket心跳PING停止发送致连接断开？如何维持PING发送？

1. PING停止发送会导致连接断开吗？ #

会。从你的调试日志可以看到，最后一次客户端PING发送于12:55:43，之后客户端完全停止发送PING，但服务器仍持续推送PONG。Stomp的心跳机制是双向校验：

• 服务器会监控客户端的PING，若长时间收不到，会判定客户端失联并主动断开WebSocket连接；
• 客户端自身的心跳定时器异常停止后，内部健康检测逻辑也会判定连接失效，触发重连。
  日志中12:56:22的断开时间，正好是最后一次PING后39秒，远超10秒的心跳间隔，符合超时断开的逻辑。

2. 如何保证PING持续发送？ #

从服务端、客户端、网络层三个维度排查优化：

服务端（Spring Boot）优化 #

不要手动创建TaskScheduler：你当前代码里new DefaultManagedTaskScheduler()会导致心跳调度器脱离Spring容器管理，容易出现线程泄漏或定时器失效。改用容器托管的调度器：

@Configuration
@EnableWebSocketMessageBroker
public class WebSocketConfig implements WebSocketMessageBrokerConfigurer {

    @Autowired
    private TaskScheduler taskScheduler;

    @Override
    public void configureMessageBroker(MessageBrokerRegistry registry) {
        registry.enableSimpleBroker("/topic")
                .setHeartbeatValue(new long[]{10000, 10000})
                .setTaskScheduler(taskScheduler);
        registry.setApplicationDestinationPrefixes("/app");
    }
}

Spring Boot默认会自动配置ThreadPoolTaskScheduler，直接注入即可确保心跳线程被正确管理。

客户端（StompJS）优化 #

1. 显式配置并监控心跳状态：确保心跳参数生效，同时添加错误监听排查异常：

const stompClient = new StompJs.Client({
    brokerURL: 'wss://example.com/ws',
    heartbeatIncoming: 10000,
    heartbeatOutgoing: 10000,
    debug: (str) => console.log(new Date().toTimeString().slice(0,8), '::', str),
    onStompError: (frame) => {
        console.error('STOMP错误:', frame.headers['message'], frame.body);
    },
    onWebSocketError: (error) => {
        console.error('WebSocket错误:', error);
    }
});

stompClient.onConnect = (frame) => {
    console.log('连接成功:', frame);
    // 部分StompJS版本可直接检查心跳定时器状态
    if (stompClient.heartbeatTimer) {
        console.log('心跳定时器已激活');
    }
};

stompClient.activate();

2. 处理浏览器后台限制：当页面被隐藏（如切换标签页），浏览器会降低定时器频率，导致PING发送中断。添加页面可见性监听，恢复页面时重连：

document.addEventListener('visibilitychange', () => {
    if (!document.hidden && !stompClient.connected) {
        stompClient.activate();
    }
});

网络层排查 #

如果你的服务部署在反向代理（如Nginx）后，检查代理的超时配置。Nginx默认proxy_read_timeout为60秒，若客户端PING间隔10秒，但代理长时间没收到客户端数据（比如PING停止），会主动断开连接。调整配置：

location /ws {
    proxy_pass http://你的后端服务地址;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 300s; # 设为大于心跳间隔的3倍以上
}

版本检查 #

升级StompJS到最新稳定版（如@stomp/stompjs@7.x），旧版本存在心跳定时器泄漏的已知bug，可能导致PING发送停止。

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