当前位置：首页 > news >正文

Spring Cloud Gateway整合基于STOMP协议的WebSocket实战及遇到问题解决

news 2026/4/4 5:57:03

本实例介绍了Spring Cloud Gateway整合基于STOMP协议的WebSocket的实现。开发了聊天功能，和用户在线状态。解决了协议gateway整合websocket出现的问题

技术点

Spring Cloud Gateway
Nacos
WebSocket
STOMP

WebSocket与STOMP协议详解

1. WebSocket

WebSocket 是一种通信协议，提供了在客户端和服务器之间建立全双工通信的功能。这意味着客户端和服务器可以在任意时间相互发送数据，而不必遵循请求-响应的传统模式（如HTTP）。

特点：

双向通信：与传统的HTTP不同，WebSocket允许服务器主动向客户端推送数据，而不必等待客户端请求。
持久连接：WebSocket连接一旦建立，可以一直保持连接，直到任意一方关闭它。这减少了频繁建立连接的开销。
低延迟：由于WebSocket消除了HTTP请求的头部开销和连接延迟，因此它适合于对延迟敏感的应用，如在线游戏、股票交易和聊天应用。

工作流程：

连接建立：客户端通过HTTP的升级机制（Upgrade header）请求建立WebSocket连接。
数据传输：一旦连接建立，客户端和服务器可以通过这个连接双向传输数据，使用一种轻量级的帧格式。
连接关闭：任意一方可以随时关闭连接，通知对方连接已关闭。

使用场景：

实时聊天应用
实时数据流（如股票行情、体育比赛更新）
在线多人游戏
实时协作工具（如Google Docs）

2. STOMP

STOMP（Simple Text Oriented Messaging Protocol） 是一种简单的文本协议，用于在客户端和消息代理（例如，RabbitMQ、ActiveMQ）之间交换消息。它是应用层的协议，常用于消息传递系统，提供了一种基于消息的通信方式。

特点：

简单易用：STOMP使用类似于HTTP的文本格式，非常容易理解和实现。
基于订阅/发布模型：STOMP支持基于主题（topic）的订阅/发布模型，这使得消息可以广播给多个客户端。
支持消息队列：STOMP支持将消息发送到队列，多个消费者可以从同一个队列中读取消息，确保负载均衡。

常用命令：

CONNECT：客户端请求连接到STOMP服务器。
SEND：客户端发送一条消息到指定的目的地（如某个队列或主题）。
SUBSCRIBE：客户端订阅某个目的地，以接收该目的地的所有消息。
UNSUBSCRIBE：取消订阅。
DISCONNECT：断开与STOMP服务器的连接。

STOMP和WebSocket的结合：

虽然WebSocket本身是一个很好的低延迟双向通信工具，但它只提供了一种基础的传输方式，没有定义消息的格式或通信模式。STOMP可以在WebSocket之上运行，提供了消息格式、路由、确认等高级功能。

例如，在一个实时聊天应用中，WebSocket用于底层的双向通信，而STOMP则负责处理消息的路由和格式化：

客户端通过WebSocket连接到服务器，并通过STOMP发送或订阅消息。
服务器使用STOMP协议将消息广播给所有订阅了相应主题的客户端。

WebSocket服务端

依赖

<!-- WebSocket依赖 -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-websocket</artifactId>
</dependency>
<!-- nacos依赖 -->
<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency><groupId>com.alibaba.nacos</groupId><artifactId>nacos-client</artifactId>
</dependency>
<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

枚举类

package com.inspur.message.constant;import lombok.AccessLevel;
import lombok.AllArgsConstructor;@AllArgsConstructor(access = AccessLevel.PRIVATE)
public enum MessageTypeEnum {TEXT("文本"),IMAGE("图片"),VOICE("语音"),FILE("文件"),EMOJI("表情"),SYSTEM_NOTIFICATION("系统通知"),LOCATION("位置"),LINK("链接"),RECALL("撤回"),MENTION("@提及"),SYSTEM_MESSAGE("系统提示"),VIDEO("视频"),RED_PACKET("红包"),VOTE("投票"),FRIEND_SHARE("好友分享");// 其他可能的消息类型...private String description;public String getDescription() {return description;}public static boolean isFileMessageType(MessageTypeEnum messageType) {return messageType == IMAGE || messageType == VOICE || messageType == FILE || messageType == VIDEO;}
}

WebSocket配置类

package com.inspur.message.config;import org.springframework.context.annotation.Configuration;
import org.springframework.messaging.simp.config.MessageBrokerRegistry;
import org.springframework.web.socket.config.annotation.EnableWebSocketMessageBroker;
import org.springframework.web.socket.config.annotation.StompEndpointRegistry;
import org.springframework.web.socket.config.annotation.WebSocketMessageBrokerConfigurer;@Configuration
@EnableWebSocketMessageBroker//注解开启STOMP协议来传输基于代理的信息，实现实时双向通信和消息传递
public class WebSocketConfig implements WebSocketMessageBrokerConfigurer {/*** 客户端在订阅或发布消息到目的地路径前，要连接到该端点** @param registry*/@Overridepublic void registerStompEndpoints(StompEndpointRegistry registry) {registry.addEndpoint("/ws").setAllowedOrigins("*").withSockJS();// 启用 SockJS (浏览器不支持WebSocket，SockJS 将会提供兼容性支持)}/*** 配置消息代理** @param register*/@Overridepublic void configureMessageBroker(MessageBrokerRegistry register) {/*** 放开的前缀路由，客户端才能接收对应路由开头的信息

技术点