Spring WebSocket（STOMP over SockJS）无法向/queue/test推送消息

根据你描述的情况，WebSocket连接正常但客户端收不到/queue/test的消息，结合你的配置和代码，以下是几个关键排查点和解决方法：

1. 确认Simple Broker前缀覆盖所有用到的目的地 #

你的配置里仅指定了/queue作为simple-broker的前缀，若测试过/topic也无效，需要同时添加两个前缀：

<websocket:simple-broker prefix="/queue,/topic" />

Simple Broker只会处理前缀匹配的目的地，未包含的前缀对应的消息会被直接丢弃。

2. 确保客户端订阅时机正确 #

订阅操作必须在STOMP连接成功建立之后执行，不能提前发起。需将订阅逻辑放在connect方法的回调函数内：

stompClient.connect({}, function(frame) {
  console.log('Connected: ' + frame);
  // 连接成功后再执行订阅
  stompClient.subscribe('/queue/test', function(message) {
    console.log("Received test message:", message.body);
  });
}, function(error) {
  console.error('Connection error:', error);
});

若在连接完成前就发起订阅，订阅请求不会被服务器处理，自然无法接收后续消息。

3. 用户特定队列的正确用法 #

如果是给单个用户推送消息，不能直接使用convertAndSend("/queue/test")，而要调用convertAndSendToUser方法，同时客户端需订阅/user/queue/test：

后端代码修改： #

// 需指定目标用户名，匿名用户场景下Spring会自动用会话ID作为用户标识
messagingTemplate.convertAndSendToUser("目标用户名", "/queue/test", message);

客户端订阅： #

stompClient.subscribe('/user/queue/test', function(message) {
  console.log("Received user-specific message:", message.body);
});

若允许匿名用户访问WebSocket，需在配置中添加匿名权限：

<security:http pattern="/ws/**" security="none" />

或在Java配置类中设置setAllowedOrigins("*")（仅建议开发环境使用）。

4. 开启STOMP调试排查帧交互 #

在客户端开启调试模式，查看STOMP帧的发送和接收细节，确认订阅是否成功、消息是否到达客户端：

stompClient.debug = function(str) {
  console.log('[STOMP Debug]', str);
};

通过调试日志可以验证：

• 客户端发送的SUBSCRIBE帧是否收到服务器的RECEIPT确认
• 服务器是否向客户端推送了MESSAGE帧

5. 检查消息目的地的完全匹配 #

确保后端发送的目的地与客户端订阅的地址完全一致，避免大小写错误、多余斜杠（如/queue//test）等问题。

6. 排查Spring版本兼容性 #

若使用的是较旧的Spring版本（如Spring 4.x早期版本），可能存在STOMP队列处理的bug，建议升级到稳定的Spring 5.x或更高版本。

你提到前端发布的消息能正常接收，说明基础的STOMP连接和消息代理逻辑是正常的，问题大概率出在消息推送的目的地配置、订阅时机或用户队列的用法上。

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