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 函数引用。

js
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。示例使用可取消的模拟接口,让不同关键词具有不同延迟,便于稳定复现竞态。

js
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 />);

预期结果:

text
页面初始搜索 react。
在 1.2 秒内把输入改为 hooks,react 请求会被 cleanup 取消。
约 0.6 秒后页面只显示“hooks 基础”和“hooks 实战”,旧结果不会覆盖新结果。

keyword 每次变化都会触发旧 Effect 的 cleanup。旧控制器被中止后,模拟接口以 AbortError 结束;代码忽略这种预期取消,只把真正的失败写入错误状态。

验证清理是否完整

可以快速连续修改关键词,确认页面最终始终对应最后一次输入。也可以卸载包含该组件的页面,检查控制台没有卸载后更新状态的异常,网络面板中的旧请求应显示为已取消。

常见错误包括:在 cleanup 中再次创建资源、移除监听器时临时声明一个新函数、把 AbortError 当成普通失败提示,以及在旧请求的 finally 中把新请求的 loading 状态提前关闭。

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

目录与阅读设置

阅读设置

17

记录一个想法

副作用清理与竞态处理

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

登录哪都通