Spring Boot应用WebSocket用户通知无法接收问题求助

我正在开发基于Spring Boot（v3.2.4）的应用，采用WebSocket实现实时通信，搭建了向指定用户推送通知的系统，但客户端始终无法接收通知。已完成的配置如下：

• 编写了带有@SubscribeMapping和@SendToUser注解的NotificationListener类；
• 实现了负责创建、保存并通过WebSocket发送通知的NotificationService；
• 配置了WebSocketConfig，包含消息代理、端点及JWT握手拦截器；
• 配置了JwtAuthenticationFilter与SecurityConfig处理认证与安全。

日志显示WebSocket连接正常、通知已保存并发送、客户端订阅的目标地址与推送地址匹配、用户身份一致，但客户端仍收不到通知。已卡壳3周，以下是针对性排查建议：

核心排查方向 #

1. @SendToUser 路径格式校验 #

• 确认推送路径是否遵循Spring默认规则：服务端用@SendToUser("/topic/notifications")时，客户端需订阅/user/topic/notifications，而非直接/topic/notifications；
• 若WebSocketConfig中自定义了setUserDestinationPrefix，需确保客户端订阅路径与服务端推送路径的前缀完全统一。

2. 消息代理路径匹配验证 #

• 检查WebSocketConfig中enableSimpleBroker配置的前缀（如/topic/、/queue/），确保推送目标路径在代理覆盖范围内；
• 核对路径拼写细节：大小写、斜杠位置是否完全一致，日志的字符串匹配可能忽略代理转发的严格格式校验逻辑。

3. JWT握手拦截器的身份传递 #

• 验证拦截器是否正确将用户身份存入WebSocketSession：需确保解析后的JWT用户信息，被放入session.getAttributes()的SPRING_SECURITY_CONTEXT或约定的用户键中；
• 确认@SendToUser获取用户身份的逻辑与拦截器一致，比如避免拦截器存用户ID、但注解用Principal.getName()取用户名的不匹配问题。

4. 客户端订阅时机与令牌传递 #

• 检查客户端连接WebSocket时是否携带正确JWT：部分客户端库需在连接阶段单独配置请求头传递令牌，而非仅在后续消息中携带；
• 确保客户端在onOpen回调触发后再执行订阅操作，避免订阅时连接未完全建立。

5. 消息发送逻辑的细节检查 #

• 确认NotificationService使用SimpMessagingTemplate.convertAndSendToUser()时参数正确：第一个参数为用户标识（需与WebSocketSession中的身份一致），第二个为目标路径，第三个为消息体；
• 在发送逻辑中添加异常捕获日志，排查是否存在未被记录的发送失败情况（如消息序列化异常）。

6. Spring Security 权限冲突排查 #

• 检查SecurityConfig是否对/user/**等WebSocket用户路径设置了过严拦截，导致消息无法正常转发；
• 确认WebSocket安全配置与消息代理配置配合正确：通过configureMessageBroker中的setDestinationPrefixes和enableSimpleBroker，确保代理路径不受Security过滤器拦截。

7. 框架版本兼容性验证 #

• 查阅Spring Boot 3.2.4对应Spring WebSocket版本的官方文档或GitHub Issues，确认是否存在@SendToUser推送的已知bug，必要时尝试小幅升级或降级版本验证。

内容的提问来源于stack exchange，提问作者Steph af