React / 系统课时

缓存与重新获取

缓存与重新获取

缓存解决的不是“永远不请求”,而是让同一份服务端数据在多个组件之间复用,并在合适的时机重新获取。理解缓存键、数据新鲜度、失效与重复请求合并后,你就能判断一次请求为什么被复用、为什么重新发送,以及刷新后哪些组件会同步更新。

学习目标

  • 理解缓存键如何决定数据是否共享,以及键中为什么必须包含查询参数。
  • 区分“数据变旧”“缓存失效”和“立即重新获取”三个概念。
  • 通过同一缓存键的两个组件观察请求合并与失效刷新。

缓存键决定共享边界

缓存键可以理解为服务端数据在客户端缓存中的“地址”。两个查询只有在缓存键相同时,才会读写同一份缓存;查询条件不同却复用同一个键,会把本来不同的数据错误地当成同一份。

例如用户维度的待办列表应把 userId 放进键中:['todos', userId]。当 userId 从 1 变成 2 时,缓存系统会切换到另一条记录,而不是覆盖原用户的数据。

失效与重新获取不是一回事

缓存通常同时关心“有没有数据”和“这份数据还新不新”。以常见查询库的模型来说,staleTime 可以规定数据在多长时间内保持 fresh;超过时间后,数据可以继续显示,但已经允许在合适时机重新获取。

“失效”则是主动把某类缓存标记为过期。失效本身不等于删除缓存,也不一定意味着所有查询立刻发请求;对于当前正在被组件订阅的查询,常见行为是尽快重新获取并用新结果更新缓存。

这能形成一个很实用的策略:读取时尽量复用缓存,写操作成功后只让相关缓存失效,再由查询层统一刷新,而不是手工把每个组件的数据分别改一遍。

重复请求如何被合并

当多个组件几乎同时请求同一个缓存键时,成熟的数据查询库通常不会为每个组件各发一次网络请求。第一个查询创建正在进行中的 Promise,后续相同键的订阅者复用它;请求完成后,结果写入同一缓存并通知所有订阅者。

相同缓存键下的请求合并与失效刷新流程

请求合并只能减少“同一时刻、同一键”的重复工作,它不会让缓存永久有效。键不同、缓存已失效、组件重新挂载且策略允许刷新时,都可能产生新的请求。

用一个小实验观察行为

下面示例假设你已在 React 项目中安装 @tanstack/react-query。两个面板使用完全相同的缓存键,因此首次渲染只执行一次 queryFn;点击“使缓存失效并刷新”后,活动查询会再次获取数据。

tsx
import React from 'react';
import { createRoot } from 'react-dom/client';
import {
  QueryClient,
  QueryClientProvider,
  useQuery,
  useQueryClient,
} from '@tanstack/react-query';

const queryClient = new QueryClient();
let requestCount = 0;

async function fetchTodos() {
  requestCount += 1;
  console.log(`request #${requestCount}`);

  // 模拟一次真实异步请求,两个相同 queryKey 会共享这一过程。
  await new Promise((resolve) => setTimeout(resolve, 500));

  return [{ id: 1, title: '理解缓存键' }];
}

function TodoPanel({ name }: { name: string }) {
  const { data, isPending } = useQuery({
    queryKey: ['todos', 1],
    queryFn: fetchTodos,
    staleTime: 30_000,
  });

  return (
    <section>
      <h2>{name}</h2>
      <p>{isPending ? '加载中...' : data?.[0].title}</p>
    </section>
  );
}

function App() {
  const client = useQueryClient();

  return (
    <main>
      <TodoPanel name={'面板 A'} />
      <TodoPanel name={'面板 B'} />
      <button
        onClick={() => client.invalidateQueries({ queryKey: ['todos', 1] })}
      >
        使缓存失效并刷新
      </button>
    </main>
  );
}

createRoot(document.getElementById('root')!).render(
  <QueryClientProvider client={queryClient}>
    <App />
  </QueryClientProvider>,
);

预期结果

text
首次打开页面:
控制台只出现 request #1
面板 A 和面板 B 都显示“理解缓存键”

点击“使缓存失效并刷新”:
控制台出现 request #2
两个面板继续从同一缓存条目获得最新结果

如果你把其中一个面板的缓存键改成 ['todos', 2],它就会成为另一条独立查询,并产生自己的请求。这也是排查“为什么重复请求没有被合并”时最先应该检查的地方。

什么时候应该主动重新获取

重新获取应当由数据一致性需要驱动,而不是由“担心缓存旧了”驱动。窗口重新聚焦、网络恢复、组件重新挂载、用户手动刷新,以及新增或修改数据成功后,都是常见触发点;具体启用哪些行为要看数据对实时性的要求。

对于变化很少的数据,可以设置较长的新鲜时间以减少请求;对于库存、协作状态等高时效数据,则应缩短新鲜时间,或使用更明确的轮询、推送机制。缓存的目标始终是用可接受的一致性成本换取更少的等待和重复请求。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

缓存与重新获取

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通