多个 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 状态,只要请求逻辑在组件内部,两边也没有共享的请求状态。
实施步骤
- 选定一个数据请求库,并在应用根部提供 Provider。
- 为每个 API 定义稳定的 queryKey 和 queryFn。
- 把请求封装成自定义 Hook,组件只调用 Hook。
- 按业务设置 staleTime、失效和刷新策略。
- 写操作完成后,让对应的 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 重复执行的问题;请求逻辑本身要能去重,不能指望调试环境。
备注:内容仅供参考。
