使用@stomp/stompjs时Spring Websocket无法监听UNSUBSCRIBE事件如何解决
问题根因及解决方案
可能原因1:UNSUBSCRIBE帧被后端前置拦截器/安全规则拦截
虽然浏览器显示消息已经发送,但Spring的安全层(如CSRF校验)或者自定义的前置拦截器可能会直接丢弃UNSUBSCRIBE帧,不会将其交给消息Broker处理,自然不会触发SessionUnsubscribeEvent。
解决办法:
先添加入站消息拦截器确认是否收到UNSUBSCRIBE帧:
@Component public class StompFrameLogInterceptor implements ChannelInterceptor { @Override public Message<?> preSend(Message<?> message, MessageChannel channel) { StompHeaderAccessor accessor = MessageHeaderAccessor.getAccessor(message, StompHeaderAccessor.class); if (accessor != null && StompCommand.UNSUBSCRIBE.equals(accessor.getCommand())) { System.out.println("收到UNSUBSCRIBE帧,头信息:" + accessor.toMap()); } return message; } }
在WebSocket配置类中注册拦截器:
@Configuration @EnableWebSocketMessageBroker public class WebSocketConfig implements WebSocketMessageBrokerConfigurer { @Override public void configureClientInboundChannel(ChannelRegistration registration) { registration.interceptors(new StompFrameLogInterceptor()); } }
如果拦截器没有打印对应的日志,说明帧被拦截,优先排查CSRF配置,放行WebSocket端点的CSRF校验:
@Configuration public class SecurityConfig extends WebSecurityConfigurerAdapter { @Override protected void configure(HttpSecurity http) throws Exception { http.csrf().ignoringAntMatchers("/websocket-endpoint/**");// 替换为你实际的WebSocket端点路径 } }
可能原因2:使用的Spring版本存在已知bug
Spring 5.3.x之前的部分版本、4.x的大部分版本都存在SessionUnsubscribeEvent不发布的已知问题,属于框架本身的缺陷。
解决办法:
升级Spring Framework到5.3.20+,或者Spring Boot到2.7.0+的稳定版本即可修复。
可能原因3:取消订阅后立即断开连接导致处理中断
你贴的取消订阅代码看起来是前端框架的清理回调(如React useEffect的清理函数),如果取消订阅后立刻触发了WebSocket断开,后端会优先处理DISCONNECT请求,UNSUBSCRIBE的处理逻辑会被中断,事件自然不会发布。
解决办法:
- 测试时先执行取消订阅,等待2s后再断开连接,验证是否能触发事件
- 生产环境可以选择在
SessionDisconnectEvent中统一清理用户的所有订阅,不需要依赖单个UNSUBSCRIBE事件
可能原因4:自定义了消息处理逻辑绕过了Broker
如果你重写了STOMP消息的路由逻辑,没有将UNSUBSCRIBE帧交给Spring自带的SimpleBroker或StompBrokerRelay处理,Broker就不会发布对应的事件。
解决办法:
确保UNSUBSCRIBE帧会被默认的Broker处理器处理,或者你在自定义逻辑中手动发布SessionUnsubscribeEvent:
// 自定义逻辑中收到UNSUBSCRIBE帧后手动发布事件 applicationContext.publishEvent(new SessionUnsubscribeEvent(this, message, accessor.getUser()));
内容的提问来源于stack exchange,提问作者André Silva

