React / 系统课时
副作用清理与竞态处理
副作用清理与竞态处理
本课解决 Effect 重复执行或组件卸载后,定时器、监听器和异步请求仍继续工作的隐患。你将通过清理函数与 AbortController,避免资源泄漏和旧请求覆盖新结果。
学习目标
- 理解 cleanup 在依赖变化和卸载时的执行顺序
- 正确清理定时器、事件监听器和异步请求
- 识别并修复“后发请求先返回”的竞态问题
清理函数解决什么问题
Effect 可以返回一个 cleanup 函数。依赖变化时,React 先用旧依赖执行 cleanup,再用新依赖运行 setup;组件卸载时,React 还会执行最后一次 cleanup。
没有清理时,旧定时器会继续触发,旧监听器会重复响应,未完成请求也可能在界面切换后回写状态。清理的目标不是“让报错消失”,而是撤销当前 Effect 建立的外部连接。
| 资源 | setup | cleanup |
|---|---|---|
| 定时器 | setTimeout、setInterval |
clearTimeout、clearInterval |
| 事件监听 | addEventListener |
使用同一个函数引用调用 removeEventListener |
| 网络请求 | 创建并发出请求 | 调用 AbortController.abort() 或忽略过期结果 |
| 第三方订阅 | subscribe、connect |
unsubscribe、disconnect |
竞态为什么会覆盖正确结果
用户先搜索 react,随后立即搜索 hooks。如果第一个请求更慢,它可能在第二个请求之后返回,并把页面重新覆盖成旧关键词的结果。

解决竞态的核心不是猜测请求耗时,而是让旧 Effect 在失效时失去写入资格。可以真正取消的请求优先取消;无法取消的 Promise,则使用布尔标记或递增请求编号,只接收当前仍有效的结果。
通用清理写法
下面是放在组件内部的片段示例,依赖组件已导入 useEffect。关键点是 setup 与 cleanup 成对出现,并且移除监听器时使用同一个 onKeyDown 函数引用。
useEffect(() => {
const timerId = setInterval(() => {
console.log('刷新一次');
}, 1000);
const onKeyDown = (event) => {
console.log(event.key);
};
window.addEventListener('keydown', onKeyDown);
return () => {
clearInterval(timerId);
window.removeEventListener('keydown', onKeyDown);
};
}, []);这段代码在组件挂载后只建立一个定时器和一个键盘监听器;组件卸载时二者都会被撤销,不会残留后台任务或重复监听。
主示例:取消过期搜索请求
下面的完整示例可直接放入 Vite React 项目的 src/main.jsx。示例使用可取消的模拟接口,让不同关键词具有不同延迟,便于稳定复现竞态。
import { useEffect, useState } from 'react';
import { createRoot } from 'react-dom/client';
function searchApi(keyword, { signal }) {
return new Promise((resolve, reject) => {
const delay = keyword === 'react' ? 1200 : 600;
const onAbort = () => {
clearTimeout(timerId);
signal.removeEventListener('abort', onAbort);
reject(new DOMException('请求已取消', 'AbortError'));
};
const timerId = setTimeout(() => {
signal.removeEventListener('abort', onAbort);
resolve([`${keyword} 基础`, `${keyword} 实战`]);
}, delay);
if (signal.aborted) {
onAbort();
return;
}
signal.addEventListener('abort', onAbort, { once: true });
});
}
function App() {
const [keyword, setKeyword] = useState('react');
const [results, setResults] = useState([]);
const [loading, setLoading] = useState(false);
const [error, setError] = useState('');
useEffect(() => {
const normalized = keyword.trim();
if (!normalized) {
setResults([]);
setLoading(false);
return undefined;
}
const controller = new AbortController();
setLoading(true);
setError('');
searchApi(normalized, { signal: controller.signal })
.then((data) => {
setResults(data);
})
.catch((requestError) => {
if (requestError.name !== 'AbortError') {
setError(requestError.message);
}
})
.finally(() => {
if (!controller.signal.aborted) {
setLoading(false);
}
});
return () => {
controller.abort();
};
}, [keyword]);
return (
<main>
<label>
搜索:
<input
value={keyword}
onChange={(event) => setKeyword(event.target.value)}
/>
</label>
{loading && <p>加载中...</p>}
{error && <p>请求失败:{error}</p>}
<ul>
{results.map((item) => (
<li key={item}>{item}</li>
))}
</ul>
</main>
);
}
createRoot(document.getElementById('root')).render(<App />);预期结果:
页面初始搜索 react。
在 1.2 秒内把输入改为 hooks,react 请求会被 cleanup 取消。
约 0.6 秒后页面只显示“hooks 基础”和“hooks 实战”,旧结果不会覆盖新结果。keyword 每次变化都会触发旧 Effect 的 cleanup。旧控制器被中止后,模拟接口以 AbortError 结束;代码忽略这种预期取消,只把真正的失败写入错误状态。
验证清理是否完整
可以快速连续修改关键词,确认页面最终始终对应最后一次输入。也可以卸载包含该组件的页面,检查控制台没有卸载后更新状态的异常,网络面板中的旧请求应显示为已取消。
常见错误包括:在 cleanup 中再次创建资源、移除监听器时临时声明一个新函数、把 AbortError 当成普通失败提示,以及在旧请求的 finally 中把新请求的 loading 状态提前关闭。