Swift项目使用StompClientLib时stompClient回调未触发问题咨询

你给出的回调是StompClientLib框架中StompClientLibDelegate协议的核心消息接收方法，具体作用和未触发原因如下：

1 回调函数的作用 #

该方法是STOMP客户端的消息推送监听回调，当你完成以下两个前置操作后，后端推送的消息会通过该方法返回：

• 客户端和SpringBoot服务端的WebSocket连接、STOMP握手成功
• 客户端已调用订阅方法，订阅了对应destination（目的地）路径的消息
  方法各参数含义：
• jsonBody：后端返回的JSON格式消息被自动解析后的对象
• stringBody：后端返回消息的原始字符串格式内容
• header：本次STOMP消息帧携带的头信息
• destination：本条消息对应的订阅目的地路径，可用来区分不同业务场景的消息
  你给出的回调实现代码如下：

func stompClient(client: StompClientLib!, didReceiveMessageWithJSONBody jsonBody: AnyObject?, akaStringBody stringBody: String?, withHeader header: [String : String]?, withDestination destination: String) {
    print("Value  : \(destination), \(String(describing: jsonBody)) & \(stringBody ?? "nil")")
}

2 回调未触发的可能原因 #

可按客户端、服务端两个维度排查：

客户端（Swift端）排查项

• 未正确设置代理：使用该库必须将实现了回调方法的类赋值给stompClient的delegate属性，即需要写stompClient.delegate = self，漏写时代理方法不会被触发
• 订阅路径不匹配：前端订阅的destination路径和后端推送的路径不一致，比如SpringBoot配置了/topic作为广播消息前缀，前端订阅时漏写该前缀，或者路径拼写错误
• 订阅/连接未成功：WebSocket握手失败、STOMP连接未完成、订阅请求被服务端拒绝，都会导致无法收到消息，可先实现框架的错误回调方法排查连接、订阅阶段的报错
• 消息格式不符合解析要求：后端返回的非标准STOMP MESSAGE帧、或者响应头content-type设置错误，会导致库无法识别有效消息，不会触发该回调
• 网络权限/状态异常：iOS端未配置网络权限、应用切后台后WebSocket连接被系统回收，都会导致无法接收消息

服务端（SpringBoot端）排查项

• STOMO配置错误：未添加@EnableWebSocketMessageBroker注解开启WebSocket消息代理，或者端点、消息前缀配置不符合约定
• 推送路径错误：使用SimpMessagingTemplate推送消息时，填写的目的地路径和前端订阅的路径不一致；如果是点对点消息，使用convertAndSendToUser方法时需要注意前端订阅路径要加/user/前缀
• 跨域配置缺失：未放行WebSocket握手请求的跨域规则，会导致前端无法成功建立连接
• 权限拦截未通过：服务端配置了STOMP消息拦截器，前端订阅请求未携带校验凭证（比如token），被拦截后订阅失败，自然收不到后续消息

内容的提问来源于stack exchange，提问作者Punreach Rany