React前端GraphQL订阅不生效:WebSocket连接正常但useSubscription无响应
Apollo Client 2.6.x 订阅异常排查步骤
按问题出现概率从高到低排序,每一步可独立验证:
- 链路顺序错误,split判断逻辑被前置链接截胡
ApolloLink按数组顺序从上到下执行流程,一旦遇到终结型链接(即直接返回Observable、负责实际发请求的链接,比如HttpLink、uploadLink这类),后续的链接逻辑就不会被执行。当前配置把split逻辑放在数组最后一位,如果uploadLink是处理文件上传的终结型HttpLink,所有请求会直接在uploadLink节点按HTTP方式发出,根本走不到后面的split判断,自然不会触发WebSocket订阅请求。
排查方法:在splitByOperation函数内增加打印,确认调用useSubscription时函数是否被触发:
如果控制台没有对应打印,就说明前置的uploadLink把请求拦截了。修正方向:把split逻辑作为整个链路的终结节点,和文件上传的逻辑做合并判断,不要把终结型链接放在split之前。function splitByOperation({ query }) { const { kind, operation } = getMainDefinition(query); console.log('split检测到操作类型', kind, operation); return kind === 'OperationDefinition' && operation === 'subscription'; } - 嵌套解构写法导致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
相关产品推荐
相关产品推荐

