跳到正文

前端请求方案选型:fetch、Axios 与服务端状态管理(3):React、Vue 与 Nuxt 的数据工具选型

前端请求方案选型:fetch、Axios 与服务端状态管理

  1. HTTP 客户端与请求封装的边界
  2. 查询缓存、数据身份与写后同步
  3. React、Vue 与 Nuxt 的数据工具选型(当前)

请求工具的选择取决于需要维护什么:按钮触发的一次操作、多个组件共享的远程数据,还是 SSR 首屏向客户端传递的结果。三者都能调用同一个接口函数,但执行状态、缓存身份和框架数据传递承担不同职责。先用同一组需求比较,再选择 React、Vue 或 Nuxt 的接入入口。

一次传输、共享查询与 SSR 传递各有职责

用同一组场景比较

场景 需要确认的行为
两个组件读取同一用户 是否共享身份、去重和同步更新
详情 ID 改变 key 是否随参数变化,旧结果会不会覆盖新目标
保存失败或乐观更新失败 怎样回滚,错误由哪层提示
首屏 SSR 后 hydration 客户端能否复用服务端数据,每个请求是否隔离
搜索输入频繁变化 防抖、取消与缓存各由谁负责

React 中的常见选择

React 项目既可以围绕共享的远程数据组织查询,也可以围绕一次异步操作管理状态。两种方式都能调用同一个接口函数,区别在于上层想维护什么。

TanStack React Query

React Query 现在属于 TanStack Query,React 包名是 @tanstack/react-query。它适合有较多共享查询、分页、失效、mutation 和乐观更新需求的应用。React 版的概览把主要职责定义为获取、缓存、同步与更新服务端状态。

查询函数可以调用原生 fetch、Axios、Ky、生成客户端,甚至不经过 HTTP 的异步数据源。接入时要维持稳定契约:成功返回数据,失败抛出错误或返回拒绝的 Promise。底层吞掉错误后返回一个普通对象,Query 层就可能把它当成成功数据。

对于数据交互较多的 React SPA,我通常会优先评估这一方案。成本是需要学习 query key、缓存生命周期和失效规则;如果项目只有几个互不关联的请求,这套模型的收益就会变小。

SWR

SWR围绕缓存和重新验证组织数据读取,调用入口是 useSWR(key, fetcher)。相同 key 可以共享缓存,支持重新聚焦和网络恢复后的验证,适合希望使用较简洁查询接口的 React 项目。

SWR 也支持写操作、乐观更新和回滚,可以使用 mutate 或 useSWRMutation。因此,「有写操作就必须放弃 SWR」并不成立;应该比较项目里的写后同步模式,以及团队更熟悉哪套 API。mutation 文档给出了这些能力的具体用法。

ahooks useRequest

ahooks 的 useRequest以异步 service 为入口,自动管理 data、loading、error,并提供手动执行、轮询、防抖、节流、重试和缓存等插件能力。它适合搜索、按钮操作、任务状态轮询等以执行控制为中心的需求。

例如,在 React 组件中,搜索 service 可以交给它做手动执行和防抖;这里省略输入框绑定,输入变化时调用 run(keyword):

import { useRequest } from 'ahooks';
import { searchUsers } from './user-api';

const { data, loading, error, run } = useRequest(searchUsers, {
  manual: true,
  debounceWait: 300,
});

防抖回答的是输入频繁变化时何时执行,查询缓存回答的是某份结果怎样复用与更新,二者可以同时存在。ahooks 也有 Cache & SWR 能力,不能把它简单归为没有缓存的 loading 工具;复杂项目应具体比较缓存身份、跨组件同步和失效入口。

RTK Query

RTK Query是 Redux Toolkit 提供的数据获取与缓存方案,可以集中定义 endpoint、使用 tag 表达失效关系,并生成 React hooks。其缓存与请求逻辑可以用于不同 UI,React hooks 是常见使用入口。

已经采用 Redux Toolkit 的项目,可以先评估 RTK Query,减少两套数据层并存的成本。尚未采用 Redux 的小项目,则需要把新增 Redux 体系的成本一起计算,不能只比较某个请求 hook 的行数。

Vue 中的常见选择

Vue 生态既有响应式请求工具,也有完整的查询缓存方案。函数名里的 use 只表示组合式使用方式,不能代表它们共享同一套缓存模型。Vue 项目的选型还要检查响应式参数如何进入 key,以及 SSR 下实例如何隔离。

VueUse useFetch 与 useAsyncState

VueUse 的 useFetch为 fetch 增加响应式状态、取消、超时、生命周期 hooks 和按 URL 变化重新执行的能力;createFetch 可以建立带默认配置的项目入口。

import { useFetch } from '@vueuse/core';

const { data, error, isFetching, execute } = useFetch('/api/users/42', {
  immediate: false,
}).json();

如果已有一个返回 Promise 的业务函数,可以使用 useAsyncState管理执行结果和状态;Axios 用户也可以评估 VueUse integrations 中的 useAxios。

这些工具适合局部异步需求。只有 loading、error、取消和重新执行时,使用它们很直接;如果已经在自己补全局 key 缓存、订阅、去重、失效与回收,就应重新评估 Query 方案。VueUse 当前这些入口也需要与独立的 VueRequest useRequest 区分。

TanStack Vue Query

@tanstack/vue-query 是 TanStack Query 的官方 Vue 适配,采用同一套 query key、QueryClient 和查询生命周期模型。它适合共享数据较多、需要明确写后同步规则的 Vue SPA,也适合希望在 React 与 Vue 之间迁移相似数据层经验的团队。

下面的片段位于组件 setup 中,假定应用已安装 VueQueryPlugin,getUser 是接收 ID 与取消信号的接口函数:

import { ref } from 'vue';
import { useQuery } from '@tanstack/vue-query';
import { getUser } from './user-api';

const userId = ref('42');

const { data, error, isPending, isFetching } = useQuery({
  queryKey: ['users', 'detail', userId],
  queryFn: ({ signal }) => getUser(userId.value, signal),
  staleTime: 30_000,
  gcTime: 5 * 60_000,
  retry: 1,
});

userId 作为 ref 放在 key 中,Vue Query 才能追踪它的变化。只在创建时取出 userId.value 并传给一个接收普通字符串的 composable,会丢掉后续变化的联系。组件 props 也有类似情况,可以传 ref、computed 或 getter。响应式文档专门说明了这些输入形态。

isPending 表示查询处于尚未获得成功数据的 pending 状态,isFetching 表示查询函数正在执行。被禁用、尚未开始请求的查询也可能处于 pending,第一次实际获取数据的 loading 状态可使用 isLoading;已有数据的后台刷新则结合 data 与 isFetching 判断。延迟查询与 loading 的说明给出了这些标记之间的关系。

这里的 30 秒新鲜期和一次重试只是示例策略,实际值要根据接口调整。signal 也要由 getUser 继续传到 fetch 或 Axios,取消能力才会落实到请求。

Pinia Colada

Pinia Colada为 Vue 提供查询缓存、请求去重、mutation、乐观更新、SSR 和与 Vue Router data loaders 的集成。它依赖 Pinia,但 Query 缓存已经由库负责,不需要再把同一份数据手工复制到另一份业务 store。

它的 API 使用 key 和 query,动态参数可以通过 getter 追踪。例如 key: () => ['users', 'detail', userId.value] 配合读取当前 ID 的 query。这与 Vue Query 的参数形状不同,迁移时应按实际查询 API调整,而不能仅替换 import。

以 Vue 为主、已经采用 Pinia 的团队,可以把它纳入首轮候选。比较重点包括查询与 mutation 的组织方式、路由集成、插件和调试工具是否适合当前项目;生态与维护情况则按准备安装的版本重新检查。

VueRequest 与 SWRV

VueRequest提供 useRequest(service) 形式的接口,覆盖手动执行、轮询、错误重试、缓存、防抖节流和分页等需求。习惯 ahooks useRequest 的开发者可以从它开始比较,尤其关注复杂场景下的共享与失效规则。

SWRV则采用 Vue Composition API 提供 SWR 风格的数据获取。它也是候选之一,不过当前 README 明确标注从 0.10.0 起移除了 SSR 支持,SSR 项目需要把这一限制纳入判断。选型不能只看工具名称与熟悉程度。

Nuxt 的数据获取应先考虑框架入口

Nuxt 自带 useFetch、useAsyncData 和 $fetch。$fetch 执行请求,useFetch 与 useAsyncData 还负责 SSR 数据及其向客户端传递,帮助客户端 hydration 时复用服务端结果。Nuxt 的数据获取文档解释了它们各自的用途。

在首屏 setup 中直接调用 $fetch,与使用带数据传递能力的入口,行为并不相同;用户点击后执行的操作,又可以直接调用相应异步函数。Nuxt 的 useFetch 与 VueUse 同名函数也有不同职责,自动导入与显式 import 应保持清楚。

普通页面取数可以先使用框架入口。出现较复杂的客户端缓存、mutation、失效和共享查询需求后,再评估 TanStack Query 或 Pinia Colada,并确定同一份数据由哪一套机制负责。引入两套缓存以后,互相更新和 SSR hydration 的成本需要一起计算。

保持一份数据的 owner

已经由 Query 管理的结果,不必再复制一份到业务 store。Nuxt 框架入口与客户端查询缓存并用时,也要明确数据传递与失效分别由谁维护。底层函数应保持成功返回数据、失败拒绝 Promise 的契约,再把取消信号传到实际请求,避免上层只改变状态而网络仍在继续。