当前位置：首页 > 文章列表 > 文章 > 前端 > GraphQL订阅实现实时更新教程

GraphQL订阅实现实时更新教程

2026-02-09 19:04:51 0浏览收藏

本篇文章向大家介绍《GraphQL订阅实现实时更新指南》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

答案：使用 Apollo Client 配置 WebSocketLink 实现 GraphQL 订阅，通过 useSubscription 监听实时数据，需前后端协同支持。

如何构建一个使用 GraphQL 订阅实现实时数据更新的前端应用？

要构建一个使用 GraphQL 订阅实现实时数据更新的前端应用，核心是通过 WebSocket 与支持订阅的 GraphQL 服务器建立持久连接，并在客户端监听数据变化。下面从关键步骤和常用技术栈出发，说明如何实现。

1. 选择合适的 GraphQL 客户端库

目前最主流的方案是使用 Apollo Client，它原生支持 GraphQL 查询、变更和订阅功能。

安装 Apollo Client 及相关依赖：

npm install @apollo/client graphql npm install subscriptions-transport-ws

其中 subscriptions-transport-ws 提供 WebSocket 支持，用于处理订阅操作。

2. 配置支持订阅的 Apollo Client

创建 ApolloClient 实例时，需要使用 WebSocketLink 来处理订阅请求，同时结合 split 将普通查询/变更与订阅请求分开处理。

示例配置代码：

import { ApolloClient, HttpLink, InMemoryCache, split } from '@apollo/client'; import { getMainDefinition } from '@apollo/client/utilities'; import { WebSocketLink } from 'subscriptions-transport-ws'; const httpLink = new HttpLink({ uri: 'http://localhost:4000/graphql', }); const wsLink = new WebSocketLink({ uri: `ws://localhost:4000/graphql`, options: { reconnect: true, }, }); const splitLink = split( ({ query }) => { const definition = getMainDefinition(query); return ( definition.kind === 'OperationDefinition' && definition.operation === 'subscription' ); }, wsLink, httpLink, ); const client = new ApolloClient({ link: splitLink, cache: new InMemoryCache() });

这样配置后，所有订阅请求会通过 WebSocket 发送，其余操作走 HTTP。

3. 定义并使用订阅查询

在组件中使用 useSubscription Hook 来监听实时数据更新。

例如，监听新消息到达：

import { useSubscription, gql } from '@apollo/client'; const NEW_MESSAGE_SUBSCRIPTION = gql` subscription OnNewMessage { messageAdded { id content sender timestamp } } `; function MessageList() { const { data, loading } = useSubscription(NEW_MESSAGE_SUBSCRIPTION); if (loading) return

正在连接...

; if (data?.messageAdded) { console.log('收到新消息:', data.messageAdded); // 更新 UI，比如添加到消息列表 } return (...); }

每当服务端触发 messageAdded 事件，客户端就会收到推送并自动更新视图。