Spring WebSocket+STOMP连接成功后报错，求问题排查与解决方法

嘿，这个问题我之前帮不少开发者排查过——核心问题出在Spring服务器端错误地把STOMP协议的控制帧当成JSON格式来解析，同时客户端收到了STOMP的协议错误帧（1007代码），才会出现这些报错。咱们一步步来解决：

问题本质拆解 #

• 你已经成功完成了WebSocket的101协议切换，但客户端发送的STOMP CONNECT帧被服务器的JSON转换器抓去解析了，这就导致了JsonParseException——毕竟CONNECT根本不是合法的JSON token。
• 服务器解析失败后，给客户端返回了STOMP错误帧c[1007,"null"]，而你的stomp.js没有正确处理这个错误类型，所以抛出了"Unhandled frame"的提示。

解决方案 #

1. 修正Spring WebSocket的消息转换器优先级 #

在你的Spring WebSocket配置类里，必须确保处理纯文本的StringMessageConverter优先级高于JSON转换器。因为STOMP的控制帧（比如CONNECT、SUBSCRIBE）都是纯文本格式，得先让它来处理，再用JSON转换器处理业务消息。

示例配置代码：

@Configuration
@EnableWebSocketMessageBroker
public class WebSocketConfig implements WebSocketMessageBrokerConfigurer {

    @Override
    public void configureMessageConverters(List<MessageConverter> converters) {
        // 先添加String转换器，处理STOMP控制帧
        converters.add(new StringMessageConverter());
        // 再添加JSON转换器，处理业务消息
        converters.add(new MappingJackson2MessageConverter());
        // 保留默认的转换器配置
        WebSocketMessageBrokerConfigurer.super.configureMessageConverters(converters);
    }

    // 注册STOMP端点（根据你的实际需求调整）
    @Override
    public void registerStompEndpoints(StompEndpointRegistry registry) {
        registry.addEndpoint("/ws").setAllowedOrigins("*").withSockJS();
    }

    // 配置消息代理（根据你的实际需求调整）
    @Override
    public void configureMessageBroker(MessageBrokerRegistry config) {
        config.enableSimpleBroker("/topic");
        config.setApplicationDestinationPrefixes("/app");
    }
}

划重点：一定要把StringMessageConverter放在最前面，顺序错了就会继续报错！

2. 确认客户端STOMP配置合规 #

确保Ionic客户端用stomp.js发送的是标准STOMP帧，不要手动修改帧格式，比如这样的配置就没问题：

import * as Stomp from '@stomp/stompjs';
import SockJS from 'sockjs-client';

connectToWebSocket() {
  const socket = new SockJS('http://你的服务器地址/ws');
  this.stompClient = Stomp.over(socket);
  
  // 用stomp.js自带的connect方法，自动生成标准CONNECT帧
  this.stompClient.connect({}, (connectFrame) => {
    console.log('连接成功：', connectFrame);
    // 订阅推送主题
    this.stompClient.subscribe('/topic/your-updates', (message) => {
      console.log('收到服务器推送：', message.body);
    });
  }, (error) => {
    console.error('连接失败：', error);
  });
}

3. 验证修复效果 #

重启Spring服务器后，再测试连接：

• 服务器端日志不再出现JsonParseException
• 客户端不会再收到1007错误帧，能正常订阅并接收推送消息

额外小提示 #

• 如果你的业务消息需要JSON格式，确保服务器端@MessageMapping方法的参数类型正确，客户端发送的消息是合法的JSON字符串。
• 检查服务器的CORS配置，确保允许你的Ionic客户端域名访问WebSocket端点。

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