Next.js/GraphQL:useSWR可否搭配apollo-client而非graphql-request?
核心结论
完全可以将useSWR与apollo-client搭配使用,不存在任何技术兼容性障碍。你不需要被“useSWR只能配graphql-request”的刻板选型思路限制,两种搭配逻辑的差异只体现在适配侧重上,没有绝对的优劣之分。
搭配的底层逻辑
useSWR的核心设计逻辑是把请求执行的权力完全交给开发者自定义的fetcher函数,只要fetcher能返回对应请求结果的Promise,它不会限制你内部执行的是REST请求、GraphQL请求还是其他异步逻辑。把apollo-client的查询执行能力封装成符合规范的fetcher,就能直接对接useSWR的缓存、自动重新验证、依赖触发请求等全套能力。
下面是最简化的实际实现示例:
// 引入项目内全局初始化完成的apollo-client实例 import apolloClient from './apollo-setup' import useSWR from 'swr' import { gql } from '@apollo/client' // 定义需要执行的GraphQL查询 const GET_ARTICLE_DETAIL = gql` query GetArticle($id: ID!) { article(id: $id) { title content viewCount } } ` // 适配useSWR的fetcher:内部调用apollo的query方法拿到数据 const graphqlFetcher = ([query, variables]) => { return apolloClient.query({ query, variables }).then(res => res.data) } // 页面组件中正常使用useSWR能力 function ArticlePage({ articleId }) { const { data, isLoading, mutate } = useSWR( [GET_ARTICLE_DETAIL, { id: articleId }], graphqlFetcher ) // 页面渲染、手动触发更新等逻辑... }
两种搭配方案的实际差异
很多开发者选择useSWR搭配graphql-request而非apollo-client,本质是基于项目现状的选型考量,不是技术上的不兼容:
- 搭配apollo-client的适用场景:适合已经在项目中深度使用apollo生态的团队,比如已经基于apollo搭建了请求拦截、全局实体缓存、本地状态管理、权限联动等复杂逻辑的项目,这种搭配可以最大化复用现有代码,不需要为了接入useSWR重写已经跑通的GraphQL请求流程,减少额外的依赖引入。
- 搭配graphql-request的适用场景:适合轻量项目,graphql-request本身是极薄的GraphQL请求封装,没有内置的独立缓存层,所有缓存、刷新、数据一致性规则完全由useSWR统一管控,不会出现两层缓存的规则冲突,整体状态流转更透明。
新手需要注意的适配坑点
- 提前处理双层缓存的冲突:apollo-client本身自带内存缓存能力,如果直接用
client.query作为fetcher,会出现apollo缓存层、useSWR缓存层并行存在的情况。要么直接关闭apollo的默认内存缓存,把所有缓存权限完全交给useSWR管控;要么明确划分两层缓存的适用边界,避免同一个请求在两层缓存中出现数据不一致的问题。 - 适配useSWR的key序列化规则:GraphQL查询文档是对象类型,无法直接作为useSWR的key值,需要把查询文档、请求变量组合成可序列化的依赖数组,保证变量变化时useSWR能正确触发重新请求。
- 不需要强行做二选一:两种请求逻辑本来就不互斥,哪怕项目主用apollo-client,遇到不需要全局实体同步的简单页面请求,也可以随时用useSWR搭配graphql-request实现轻量请求,减少不必要的全局状态占用。
内容的提问来源于stack exchange,提问作者Namu Cho
相关产品推荐
相关产品推荐

