根本原因是后端stomp端点路径、前缀配置与前端不一致：/ws端点未注册或未启用sockjs，setallowedorigins("")在spring boot 3.x+需改为setallowedoriginpatterns("")，enablesimplebroker未声明客户端订阅的/topic前缀，且/applicationdestinationprefixes与前端send路径必须严格匹配。
stomp.js 能连上 spring boot 的 websocket，但默认配置下大概率会 404 或连接后立即断开——根本原因不是前端写错了，而是后端 registerstompendpoints 和 configuremessagebroker 的路径、前缀、代理启用方式没对齐。
为什么 new Stomp.client() 一直报错“WebSocket connection closed before handshake”
这是最常见现象，本质是浏览器发出了 WebSocket 握手请求（ws://localhost:8080/ws），但后端没在该路径注册 STOMP 端点，或者注册了却没启用 SockJS 回退（当网络拦截 WebSocket 时会静默失败）。
-
registry.addEndpoint("/ws")必须和前端 URL 中的路径完全一致，比如new WebSocket("ws://localhost:8080/ws")；若写成/websocket，前端也得同步改 - 生产环境建议加
.withSockJS()，否则某些企业防火墙/代理会直接阻断 WebSocket 升级请求，而 SockJS 会自动降级为 XHR 流或 iframe - Spring Boot 3.x+ 默认禁用
setAllowedOrigins("*")，必须显式写成setAllowedOriginPatterns("*")，否则跨域预检失败，连接直接终止
configureMessageBroker 里 enableSimpleBroker 的参数决定你能订阅什么地址
前端 client.subscribe("/topic/message") 能否成功，不取决于你写了什么路径，而取决于后端 enableSimpleBroker 是否声明了 /topic 这个前缀。
- 如果只写了
config.enableSimpleBroker("/public", "/private")，那前端只能subscribe("/public/xxx")或subscribe("/private/xxx")，写/topic/xxx会静默失败（无错误日志，但收不到消息） -
/user前缀专用于点对点：后端用simpMessagingTemplate.convertAndSendToUser("userId", "/queue/message", payload)，前端需client.subscribe("/user/queue/message")，注意这里必须带/user/开头 - 心跳值不配也会导致空闲断连：
setHeartbeatValue(new long[]{10000, 10000})表示服务端每 10 秒发 ping，客户端也要在 10 秒内回 pong，否则连接关闭
@MessageMapping 方法收不到前端 send 的消息？检查 applicationDestinationPrefixes
前端调用 client.send("/app/sendMsg", {}, JSON.stringify(payload))，这个 /app 不是随便写的——它必须和后端 setApplicationDestinationPrefixes("/app") 完全一致。
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 如果后端写的是
setApplicationDestinationPrefixes("/hanhan")，前端 send 地址就必须是/hanhan/sendMsg，否则请求进不了@MessageMapping方法，也不会报错，只是被忽略 - 路径匹配是严格前缀匹配：
/app/msg可以匹配@MessageMapping("/msg")，但/app/msg/detail就不匹配@MessageMapping("/msg")，得写成@MessageMapping("/msg/**")或拆成两级 - 别在
@MessageMapping方法里 throw 异常后不处理，Spring 默认把异常转成 ERROR 帧发回前端，但 stomp.js 不自动监听 ERROR，要手动client.onerror = () => {}才能看到
Vue 项目里用 stompjs 时，client.disconnect() 不生效？
常见于页面卸载前调用 client.disconnect()，但连接实际未关闭，下次进入页面又新建连接，导致服务端堆积大量空闲会话。
- 必须传 callback：
client.disconnect(() => { console.log("disconnected"); })，否则 disconnect 是异步且无确认的 - Vue 组件中应在
onBeforeUnmount（Composition API）或beforeDestroy（Options API）里调用，不能只在mounted初始化后就不管 - 更稳妥的做法是加标识位：
let isDisconnected = false; client.disconnect(() => { isDisconnected = true; })，避免重复调用或在已断开状态下再调用
最容易被忽略的其实是心跳和线程池配置：本地开发可能一切正常，一上测试环境就频繁断连或消息延迟，问题往往出在 configureClientInboundChannel 里线程数太小，或 setHeartbeatValue 没设——这两项不显式配置，Spring Boot 会用极保守的默认值，扛不住并发连接。
