Vertx GraphQL Subscription实现及客户端WebSocket接收消息异常问题
问题根因
该问题主要由三个错误点共同导致:
- WebSocket消息发送格式不符合GraphQL Subscription协议要求
- 服务端Subscription的DataFetcher中RxJava流配置错误,无法接收到事件
- 可能存在客户端与服务端的GraphQL over WebSocket协议版本不匹配问题
修复步骤
1. 修复服务端commentAdded DataFetcher的流配置
当前实现每次调用DataFetcher时都会创建全新的ConnectableObservable,和全局BehaviorSubject的事件链独立,自然收不到addComment触发的事件,直接返回共享的Flowable即可:
public DataFetcher<Publisher<Comment>> commentAdded() { return (DataFetchingEnvironment dfe) -> // 直接返回BehaviorSubject转成的共享Flowable,不需要每次新建publish流 subject.toFlowable(BackpressureStrategy.BUFFER).share(); }
2. 修复客户端WebSocket消息发送逻辑
当前用ws.write(Buffer)发送的是二进制帧,而GraphQL over WebSocket协议默认只解析文本帧,需要改为调用writeTextMessage发送JSON字符串:
httpClient.webSocket("/graphql") .onSuccess(ws -> { ws.textMessageHandler(text -> log.info("web socket message handler:{}", text)); JsonObject messageInit = new JsonObject() .put("type", "connection_init") .put("payload", JsonObject.EMPTY_JSON); // 发送文本帧 ws.writeTextMessage(messageInit.encode()); JsonObject message = new JsonObject() .put("payload", new JsonObject() .put("query", "subscription onCommentAdded { commentAdded { id content } }")) // 旧版subscriptions-transport-ws协议用start,新版graphql-transport-ws协议改为subscribe .put("type", "start") .put("id", "1"); ws.writeTextMessage(message.encode()); }) .onFailure(e -> log.error("error: {}", e));
3. 确认服务端Subscription配置
检查服务端Vertx Web GraphQL的初始化逻辑,确保已经显式开启了Subscription支持,示例配置如下:
GraphQLRouter router = GraphQLRouter.newBuilder(graphQL) .enableSubscriptions("/graphql") // 开启WebSocket Subscription支持,路径和客户端保持一致 .build();
验证
修改完成后重新启动服务端和客户端,触发addComment mutation即可在WebSocket的消息回调中收到新增的评论数据。
内容的提问来源于stack exchange,提问作者Hantsy
相关产品推荐
相关产品推荐

