PAYATHON 2026

多个 React 组件共享相同 API 数据时如何避免重复请求

数据小陈

生产环境优先选专门的数据请求库,例如 TanStack Query、SWR、RTK Query 或 Apollo。请求去重、缓存、重新获取以及 stale data 处理,这些库已经替你做好。React Context 更适合共享状态,不负责请求去重。Redux Toolkit 可以用 RTK Query;如果只用普通 slice/createAsyncThunk,并发请求仍要自己处理。自己写 Hook 也能实现,但缓存和 in-flight Promise 必须放在 Hook 外部,还要处理失效、竞态和清理。

为什么会在两个组件里重复请求

如果 ComponentA 和 ComponentB 各自在 useEffect 里 fetch /api/users,两个组件同时挂载时会各发一次请求。就算有 loading 状态,只要请求逻辑在组件内部,两边也没有共享的请求状态。

实施步骤

  1. 选定一个数据请求库,并在应用根部提供 Provider。
  2. 为每个 API 定义稳定的 queryKey 和 queryFn。
  3. 把请求封装成自定义 Hook,组件只调用 Hook。
  4. 按业务设置 staleTime、失效和刷新策略。
  5. 写操作完成后,让对应的 queryKey 失效。

推荐做法:用数据请求库统一缓存键

以 TanStack Query 为例,把请求封装成带 queryKey 的 Hook,两个组件调用同一个 Hook。只要它们在同一个 QueryClientProvider 下使用相同 queryKey,并发请求会合并,缓存也会共享。

import { QueryClient, QueryClientProvider, useQuery } from '@tanstack/react-query';

const queryClient = new QueryClient();

async function fetchUsers() {
  const res = await fetch('/api/users');
  if (!res.ok) throw new Error(`请求失败: ${res.status}`);
  return res.json();
}

function useUsers() {
  return useQuery({
    queryKey: ['users'],
    queryFn: fetchUsers,
    staleTime: 60_000,
  });
}

function ComponentA() {
  const { data: users, isLoading, error, refetch } = useUsers();
  if (isLoading) return <p>加载中...</p>;
  if (error) return <p>加载失败</p>;
  return <UserList users={users} onRefresh={refetch} />;
}

function ComponentB() {
  const { data: users } = useUsers();
  return <UserCount count={users?.length ?? 0} />;
}

function App() {
  return (
    <QueryClientProvider client={queryClient}>
      <ComponentA />
      <ComponentB />
    </QueryClientProvider>
  );
}

这样两个组件都不需要重复写 fetch。ComponentA 和 ComponentB 同时需要数据时,TanStack Query 会按 [‘users’] 这个 key 共享缓存并合并正在进行的请求。刷新可以调用 refetch,或在写操作后执行 queryClient.invalidateQueries({ queryKey: [‘users’] })。

缓存、刷新和 stale 的取舍

  • queryKey 决定了缓存共享和失效的范围。参数不同就用不同 key,比如 [‘user’, userId];否则不同数据会混在一起。
  • staleTime 决定数据在多久内算新鲜。新鲜期内组件挂载通常直接读缓存;过期后按库的策略重新获取。用户列表这类变化较快的数据可以设短一些,字典、配置可以设长一些。
  • refetch 用于用户主动刷新或关键操作后刷新;invalidateQueries 用于标记缓存失效,并让活跃查询重新取数。
  • 缓存保留时间、垃圾回收、错误重试、窗口聚焦刷新等策略,不同库名称不同,但都应按业务选择,不要默认把所有数据永久缓存。

其他方案怎么选

  • React Context:适合把请求好的数据、loading、error 和 refresh 方法共享给子树。在 Provider 里只请求一次能避免重复,但缓存失效、参数变化、错误重试和卸载清理都得自己处理。Context 本身不做请求去重。
  • Redux Toolkit:推荐直接用 RTK Query,它提供 endpoint 缓存、请求去重和 invalidation。若用普通 createAsyncThunk,需要手动判断是否已有数据、是否有 in-flight Promise,否则仍可能重复请求。
  • 自定义 Hook:适合小规模或请求逻辑可控的场景。关键是把缓存和 in-flight Promise 放到 Hook 外部,例如模块级变量、Context 或 Store 中;如果每个组件调用 Hook 都各自 useEffect fetch,还是会重复。
  • 数据请求库:生产项目用这类库通常最省事,适合需要缓存、去重、重新获取、分页、乐观更新和 stale 管理的场景。

注意事项

别在多个组件里各复制一段 useEffect + fetch,也别把 React Context 当缓存层。暂时不引入库的话,至少要做到共享缓存、并发请求复用同一个 Promise、手动失效和错误处理。开发环境的 StrictMode 可能会暴露 effect 重复执行的问题;请求逻辑本身要能去重,不能指望调试环境。

备注:内容仅供参考。