SSE 功能
版本
= 2.2.1
配置说明
配置位于 ruoyi-resource,远程调用可使用 RemoteMessageService。

参数说明:
enabled:是否启用path:应用路径
注意:关闭 SSE 时需同步关闭前端开关,否则前端启动会报错。

补充说明:
- Cloud 版本的服务端配置实际位于 Nacos 配置
script/config/nacos/ruoyi-resource.yml。 - 前端使用方式与 Vue 版本一致,仍然依赖
.env.*中的VITE_APP_SSE、VITE_APP_CLIENT_ID和/resource/sse路径。 - 业务服务如果需要跨服务推送消息,优先通过
RemoteMessageService调用ruoyi-resource,避免各服务重复维护推送入口。 - 前端退出登录时同样会请求
/resource/sse/close关闭连接,因此网关白名单也需要保留该地址。
前端连接示例
text
http://后端ip:端口/resource/sse?clientid=import.meta.env.VITE_APP_CLIENT_ID&Authorization=Bearer <token>Authorization 为登录后获取的 token,连接成功后与其他接口的登录态一致。
补充说明:
- 实际部署时通常连接网关地址下的
/resource/sse,而不是直接访问ruoyi-resource实例。 - 前端连接、通知展示、自动重连逻辑与 Vue 版本一致,可直接参考 Vue 版本说明。
消息发送
SseMessageUtils.sendMessage:单机消息(特殊需求)SseMessageUtils.subscribeMessage:订阅分布式消息(默认已订阅)SseMessageUtils.publishMessage:发布分布式消息(推荐)SseMessageUtils.publishAll:群发消息
补充说明:
- Cloud 项目中推荐统一从业务服务调用远程消息服务,再由
ruoyi-resource完成实际推送。