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(),因此只有最新关键词对应的请求可以更新页面。
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>
);
}预期结果
初始关键字为 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 中维护“是否仍有效”的标记,或者给每次请求分配递增版本号,只允许最新版本提交结果。
能取消时优先取消,因为它既阻止旧结果覆盖新结果,也减少不必要的工作;不能取消时再用结果版本校验兜底。