You need to enable JavaScript to run this app. Vertx GraphQL Subscription实现及客户端WebSocket接收消息异常问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 05:15:03