必须用enablestompbrokerrelay+rabbitmq，因enablesimplebroker不支持@sendtouser、无消息持久化、无法跨实例广播、无ack机制；rabbitmq需启用stomp插件、正确配置vhost权限及61613端口。
Spring Boot 用 STOMP 做 WebSocket 消息代理，核心不是“能不能通”，而是「消息路由是否可控」「用户隔离是否可靠」「生产环境能否扛住连接数」。直接上结论：默认 enableSimpleBroker 只适合开发调试；真实项目必须切换到 enableStompBrokerRelay + RabbitMQ（或 ActiveMQ），否则 /user 订阅、消息确认、集群扩展会全部失效。
为什么不能只用 enableSimpleBroker？
内存级 Broker 看似简单，但实际踩坑密集：
-
enableSimpleBroker("/topic", "/queue")不支持@SendToUser的会话绑定，前端用stompClient.subscribe("/user/queue/notifications")会收不到私信 - 所有连接共享一个 JVM 内存队列，服务重启后未消费消息直接丢失，无持久化能力
- 水平扩展时，A 实例发的消息无法被 B 实例的订阅者收到，
/topic广播变成单机广播 - 没有 ACK 机制，客户端断线重连期间推送的消息全丢，且无日志可查
enableStompBrokerRelay 配置 RabbitMQ 的关键参数
RabbitMQ 不是“配个地址就行”，以下字段缺一不可且极易填错：
-
setRelayHost("localhost")和setRelayPort(61613)：注意不是 RabbitMQ 的 AMQP 端口（5672），STOMP 协议需启用stomp插件并监听 61613 -
setVirtualHost("/")：RabbitMQ 默认 vhost 是/，不是空字符串或%2F，填错直接报Connection refused -
setClientLogin("guest")和setClientPasscode("guest")：Docker 启动时若未显式改密，必须用默认凭据；生产环境务必改密并配setSystemLogin -
setSystemHeartbeatSendInterval(5000)：客户端心跳超时由这个值 + RabbitMQ 的heartbeat配置共同决定，不设容易触发意外断连
示例片段：
RabbitMQ 4.2.3
下载
RabbitMQ 4.2.3 是 2026 年初发布的重要稳定更新版本，重点修复了 Khepri 元数据存储相关问题，并改进了监控性能。对于使用 Docker、Kubernetes 或微服务架构的开发团队来说，该版本兼容性和稳定性表现较好。
registry.enableStompBrokerRelay("/topic", "/queue", "/exchange", "/amq/queue")
.setRelayHost("localhost")
.setRelayPort(61613)
.setVirtualHost("/")
.setClientLogin("guest")
.setClientPasscode("guest")
.setSystemLogin("guest")
.setSystemPasscode("guest")
.setSystemHeartbeatSendInterval(5000);
前端订阅 /user 路径时的隐含规则
很多人写 stompClient.subscribe("/user/queue/msg") 收不到消息，问题不在后端配置，而在前端没传 session 或 header：
- 必须在连接时带上
headers，例如stompClient.connect({}, onConnected, { headers: { 'X-Auth-Token': token } })，否则 Spring 无法识别当前用户 ID - 后端需配合实现
WebSocketSession用户绑定，常见做法是继承HandshakeInterceptor，从请求 header 或 cookie 提取用户标识并存入attributes -
/user订阅本质是/user/{sessionId}/queue/msg，Spring 自动拼接；若 session ID 不稳定（如 Nginx 未开启 sticky session），会导致订阅失效 - 测试时用
curl -i -N -H "Accept: application/json" http://localhost:8080/ws看握手响应头，确认Sec-WebSocket-Protocol: v10.stomp存在
RabbitMQ STOMP 插件启用与权限验证
光装 RabbitMQ 不够，STOMP 协议支持是独立插件：
- Docker 启动需加参数：
docker run -d --name rabbitmq -p 5672:5672 -p 61613:61613 -e RABBITMQ_DEFAULT_USER=guest -e RABBITMQ_DEFAULT_PASS=guest rabbitmq:3-management，再进容器执行rabbitmq-plugins enable rabbitmq_stomp - 检查插件状态：
docker exec -it rabbitmq rabbitmq-plugins list | grep stomp，输出应含[E*] rabbitmq_stomp - 若连接时报
ERROR CODE 403，大概率是 vhost 权限未开：用管理界面进入Admin → Virtual Hosts → / → Permissions，给guest用户填满Configure / Write / Read - 别忽略防火墙：云服务器需放行 61613 端口，本地测试记得关掉 Windows Defender 防火墙临时规则
真正麻烦的从来不是代码写几行，而是 RabbitMQ 的 STOMP 插件状态、vhost 权限、前端 session 绑定这三处——任一缺失，/user 订阅就静默失败，连错误日志都不打。
