Spring+SockJS+Stomp除心跳外无法接收消息问题排查求助

结合你使用的Spring 4.3.6.RELEASE、stomp-websocket 2.0和sockjs-client 1.1.4版本，我来一步步帮你定位问题：

一、先检查服务器端核心配置是否完整 #

从你给出的代码片段来看，WebSocketConfig可能缺少关键的消息代理配置，这是最常见的问题根源：

1. 确认configureMessageBroker方法的配置 #

这个方法负责定义消息路由规则，必须正确设置应用前缀和代理前缀：

@Override
public void configureMessageBroker(MessageBrokerRegistry config) {
    // 客户端向服务器发送消息时的前缀，比如客户端发 /app/hello 会被服务器的@MessageMapping("/hello")处理
    config.setApplicationDestinationPrefixes("/app");
    // 启用内置消息代理，处理客户端订阅的目标前缀（比如/topic、/queue）
    config.enableSimpleBroker("/topic", "/queue");
}

如果没有配置这个方法，服务器无法正确将消息路由到订阅的客户端，自然只能收到心跳（心跳是框架自动维护的）。

2. 确认端点注册是否启用SockJS #

你的registerStompEndpoints方法需要明确添加SockJS支持，否则客户端用SockJS连接会出现协议不匹配：

@Override
public void registerStompEndpoints(StompEndpointRegistry registry) {
    registry.addEndpoint("/ws") // 定义WebSocket端点路径
            .setAllowedOrigins("*") // 本地测试允许跨域
            .withSockJS(); // 启用SockJS fallback支持
}

3. 检查消息发送的目标前缀是否正确 #

你注入了SimpMessagingTemplate，发送消息时要确保目标前缀和客户端订阅的一致，比如：

// 正确示例：发送到/topic/test，客户端需要订阅同样的路径
brokerMessagingTemplate.convertAndSend("/topic/test", "测试消息");

注意：不要给订阅目标加/app前缀，/app是客户端向服务器发消息的前缀，不是订阅的目标前缀。

二、客户端代码的常见问题 #

1. 确认订阅路径是否正确 #

客户端订阅时要直接使用代理前缀（比如/topic或/queue），不要包含/app：

const socket = new SockJS('/ws');
const stompClient = Stomp.over(socket);

stompClient.connect({}, function(frame) {
    console.log('已连接: ' + frame);
    // 订阅正确的目标路径，和服务器发送的一致
    stompClient.subscribe('/topic/test', function(message) {
        console.log('收到消息: ' + message.body);
    });
});

2. 检查Stomp客户端的连接参数 #

虽然心跳能正常接收，但可以确认一下客户端的心跳配置是否和服务器匹配（Spring默认心跳是10秒发一次），避免因心跳配置异常影响消息传输：

stompClient.connect({}, function(frame) {
    // ... 订阅逻辑
}, function(error) {
    // 加上错误回调，方便排查连接失败问题
    console.error('连接失败: ', error);
});

三、辅助排查手段 #

1. 开启Spring WebSocket的DEBUG日志 #

在你的日志配置（比如logback.xml）中添加以下配置，查看消息的流向：

<logger name="org.springframework.messaging" level="DEBUG"/>
<logger name="org.springframework.web.socket" level="DEBUG"/>

通过日志可以确认：

• 客户端的订阅请求是否被服务器接收
• 服务器发送的消息是否被正确转发到代理
• 是否有任何异常报错（比如消息序列化失败）

2. 验证跨域配置 #

虽然你设置了setAllowedOrigins("*")，但可以在浏览器控制台查看是否有CORS相关报错，避免因跨域限制导致消息被拦截。

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