Spring Boot WebSocket 如何实现多客户端实时数据同步？

本文共计1163个文字，预计阅读时间需要5分钟。

本文将简要介绍如何基于Spring Boot的STOMP实现WebSocket通信。首先，简要介绍STOMP和WebSocket的概念，然后说明如何在Spring Boot项目中配置和使用STOMP，最后通过一个示例展示如何实现简单的WebSocket通信。

在 Spring Boot 中实现多客户端自动同步，核心不是“轮询”或“手动刷新”，而是构建一个发布-订阅（Pub/Sub）式实时通信通道：当任一客户端触发变更（如新增 Collection），服务端应立即将该变更广播至所有已连接且订阅了对应主题的客户端。你当前的服务端配置已具备基础骨架，但存在几个关键缺失点——既涉及服务端逻辑完善，也依赖客户端正确接入与监听。

✅ 服务端需确保消息真正“广播出去”

你的 WebSocketConfig 配置基本正确，但注意两点：

• @EnableWebSocketMessageBroker 已替代过时的 AbstractWebSocketMessageBrokerConfigurer（Spring Boot 2.6+ 推荐继承 WebSocketMessageBrokerConfigurer）；
• enableSimpleBroker("/topic") 表示以 /topic/xxx 为前缀的主题支持服务端向所有订阅者群发，这正是自动同步所需。

然而，MessageController 中的 @MessageMapping("/chat") 仅处理“接收请求”，并通过 @SendTo("/topic/messages") 将返回值推送到 /topic/messages —— 这本身是正确的，但前提是客户端必须提前订阅 /topic/messages，否则消息发出即被丢弃。