You need to enable JavaScript to run this app. React前端GraphQL订阅不生效:WebSocket连接正常但useSubscription无响应
优惠活动
大模型
产品
解决方案
定价
更多

React前端GraphQL订阅不生效:WebSocket连接正常但useSubscription无响应

Apollo Client 2.6.x 订阅异常排查步骤

按问题出现概率从高到低排序,每一步可独立验证:

  • 链路顺序错误,split判断逻辑被前置链接截胡
    ApolloLink按数组顺序从上到下执行流程,一旦遇到终结型链接(即直接返回Observable、负责实际发请求的链接,比如HttpLink、uploadLink这类),后续的链接逻辑就不会被执行。当前配置把split逻辑放在数组最后一位,如果uploadLink是处理文件上传的终结型HttpLink,所有请求会直接在uploadLink节点按HTTP方式发出,根本走不到后面的split判断,自然不会触发WebSocket订阅请求。
    排查方法:在splitByOperation函数内增加打印,确认调用useSubscription时函数是否被触发:
    function splitByOperation({ query }) {
      const { kind, operation } = getMainDefinition(query);
      console.log('split检测到操作类型', kind, operation);
      return kind === 'OperationDefinition' && operation === 'subscription';
    }
    
    如果控制台没有对应打印,就说明前置的uploadLink把请求拦截了。修正方向:把split逻辑作为整个链路的终结节点,和文件上传的逻辑做合并判断,不要把终结型链接放在split之前。
  • 嵌套解构写法导致hook执行中断
    当前的解构代码:
    const { data: { commentAdded }, loading } = useSubscription(COMMENTS_SUBSCRIPTION);
    
    在组件首次渲染时,订阅尚未返回数据,此时data字段为undefined,直接嵌套读取data下的commentAdded会抛出属性读取错误,导致hook执行中断,不会走到发起订阅请求的逻辑。
    先替换成安全的可选链写法验证:
    const { data, loading } = useSubscription(COMMENTS_SUBSCRIPTION);
    const commentAdded = data?.commentAdded;
    
    同时确认useSubscription是从@apollo/react-hooks导入的(这是适配2.6.x版本Apollo Client的官方hooks包),如果错从3.x版本的@apollo/client导入,会出现hook和客户端版本不兼容、不发请求的问题。
  • WebSocket传输协议不匹配
    Apollo Client 2.6.4对应的官方WebSocket传输方案是apollo-link-ws搭配subscriptions-transport-ws包,这套实现的是旧版GraphQL订阅报文协议(包含connection_init、start、data这类固定type的JSON结构报文)。如果后端WebSocket服务是用新版graphql-ws包实现的,就算HTTP层完成了101握手,两边的报文格式完全不兼容:客户端连接建立后不会发送符合后端要求的初始化报文,自然也不会发送启动订阅的请求帧,后端完全感知不到客户端的订阅存在。
    排查方法:点开Chrome Network面板里的WebSocket连接条目,切换到Messages标签页,查看连接建立后是否有客户端主动发出的JSON报文。如果连接建立后没有任何客户端发送的内容,基本就是协议不匹配导致的。
  • WebSocketLink的uri配置不一致
    当前抓包看到的成功握手地址是ws://myUrl:3000/subscription,但前端Playground报的连接失败地址是不带端口的ws://myUrl/subscription,说明本地代码里wsLink的uri配置和实际可连通的地址不一致。需要确认wsLink里填写的uri是带正确端口的完整ws/wss地址,WebSocketLink不支持相对路径的uri配置。

内容的提问来源于stack exchange,提问作者FizzoDelPato

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.25 11:24:02