React / 系统课时

取消过期请求

取消过期请求

当搜索词、筛选条件或路由参数快速变化时,先发出的请求可能更晚返回,旧结果就会覆盖新结果。解决这个竞态的关键是:参数变化或组件卸载时取消旧请求,并且不要把主动取消当成真正的错误。

学习目标

  • 解释旧请求覆盖新结果的竞态是怎样发生的
  • 在 useEffect 清理函数中使用 AbortController 取消过期请求
  • 正确区分取消错误和真正的请求失败

旧请求为什么会覆盖新结果

假设用户先搜索 r,请求 A 开始;紧接着输入 react,请求 B 开始。如果 B 在 200 ms 后返回,而 A 在 800 ms 后才返回,组件会先显示 react 的结果,再被更晚完成的 A 覆盖。

参数变化时旧请求与新请求的竞态时序

useEffect 的清理函数正好提供了取消时机:依赖变化时,React 会先执行上一次 effect 的 cleanup,再执行新的 effect;组件卸载时也会执行 cleanup。

用 AbortController 绑定一次请求

下面的示例模拟一个支持 AbortSignal 的搜索请求。快速输入时,旧 effect 的清理函数会调用 abort(),因此只有最新关键词对应的请求可以更新页面。

jsx
import { useEffect, useState } from "react";

function searchUsers(keyword, signal) {
  return new Promise((resolve, reject) => {
    const delay = keyword.length <= 1 ? 800 : 200;
    const timer = setTimeout(() => {
      resolve([`${keyword}-result`]);
    }, delay);

    signal.addEventListener("abort", () => {
      clearTimeout(timer);
      reject(new DOMException("Request aborted", "AbortError"));
    });
  });
}

export default function App() {
  const [keyword, setKeyword] = useState("r");
  const [results, setResults] = useState([]);
  const [error, setError] = useState("");

  useEffect(() => {
    const controller = new AbortController();
    setError("");

    searchUsers(keyword, controller.signal)
      .then((data) => setResults(data))
      .catch((err) => {
        // 主动取消属于正常控制流,不显示为请求失败。
        if (err.name !== "AbortError") {
          setError(err.message);
        }
      });

    return () => {
      controller.abort();
    };
  }, [keyword]);

  return (
    <main>
      <input
        value={keyword}
        onChange={(event) => setKeyword(event.target.value)}
        placeholder="输入搜索词"
      />
      {error ? <p role="alert">{error}</p> : <p>{results.join(", ")}</p>}
    </main>
  );
}

预期结果

text
初始关键字为 r;如果立刻继续输入为 react,针对 r 的旧请求会在 cleanup 中被取消。
约 200 ms 后页面只显示 react-result,不会在稍后又变回 r-result。

实际等待时间取决于请求实现;示例中的 800 ms 和 200 ms 仅用于稳定复现“旧请求更晚完成”的场景。

接真实 fetch 时怎么写

浏览器原生 fetch 可以直接接收同一个 signal。核心调用形式是 fetch(url, { signal: controller.signal }),其余生命周期处理仍放在 useEffect 和 cleanup 中。组件卸载后,cleanup 也会取消尚未完成的请求,避免无意义的网络和状态更新。

什么时候还要做结果版本校验

并非所有异步 API 都支持真正取消。遇到无法接收 AbortSignal 的旧 SDK、定时任务或第三方 Promise 时,可以在 effect 中维护“是否仍有效”的标记,或者给每次请求分配递增版本号,只允许最新版本提交结果。

能取消时优先取消,因为它既阻止旧结果覆盖新结果,也减少不必要的工作;不能取消时再用结果版本校验兜底。

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

目录与阅读设置

阅读设置

17

记录一个想法

取消过期请求

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

登录哪都通