最近在把一个后台管理项目从 React 17 升到 18，开启 `createRoot` 之后，列表页的请求偶尔会发两次，详情页在快速切换时还会出现旧数据覆盖新数据的情况。排查下来并不是接口本身的问题，而是并发渲染特性让组件的挂载和副作用执行时机变得更“激进”，尤其是在 StrictMode 下开发环境会刻意双调用 effect 来帮助暴露副作用清理不彻底的问题。另外，用户在搜索框连续输入、或者从列表快速点进不同详情页时，多个异步请求的返回顺序并不保证，先发的请求可能后回来，直接把后发请求的结果覆盖掉。这篇文章结合真实的组件代码，梳理 effect 重复执行的原因、清理函数的正确写法，以及用请求取消和请求序号两种手段解决竞态，最后给出一套可复用的数据请求 hook 写法。

先看一个很典型的详情页写法，问题基本都出在这里：

```tsx
function UserDetail({ userId }: { userId: string }) {
 const [user, setUser] = useState<User | null>(null);

 useEffect(() => {
 fetch(`/api/users/${userId}`)
 .then((res) => res.json())
 .then((data) => setUser(data));
 }, [userId]);

 return <div>{user?.name}</div>;
}
```

这段代码在 React 17 里可能“看起来没问题”，但到了 18 的并发渲染加上 StrictMode，开发环境会执行两次 effect，也就是发出两次请求。生产环境虽然不会双调用，但 `userId` 快速变化时，两个请求依然会并发，谁后回来谁生效，页面就可能显示错误用户的数据。

要处理这个问题，第一步是让 effect 具备清理能力。`AbortController` 是最直接的工具，浏览器原生支持，axios 也支持传 `signal`：

```tsx
useEffect(() => {
 const controller = new AbortController();

 fetch(`/api/users/${userId}`, { signal: controller.signal })
 .then((res) => res.json())
 .then((data) => setUser(data))
 .catch((err) => {
 if (err.name === 'AbortError') return;
 console.error(err);
 });

 return () => controller.abort();
}, [userId]);
```

这样在依赖变化或者组件卸载时，旧请求会被 abort，回调里的 `setUser` 不会执行。注意 `AbortError` 要单独判断并吞掉，否则控制台会多出一堆无意义的报错。

但有些场景没法 abort，比如第三方 SDK 的回调、或者用了不支持 signal 的请求库。这时候可以用“请求序号”的方式做兜底，用一个 ref 记录当前最新的请求编号，回调里只接受和当前编号一致的结果：

```tsx
function useLatestRequest<T>() {
 const requestIdRef = useRef(0);

 const run = useCallback(async (task: () => Promise<T>): Promise<T | undefined> => {
 const id = ++requestIdRef.current;
 const result = await task();
 if (id !== requestIdRef.current) return undefined;
 return result;
 }, []);

 return run;
}
```

调用方拿到 `undefined` 就说明这次请求已经过期，直接丢弃即可。这个思路不依赖具体请求库，兼容性最好，代价是需要自己在每个回调里判断返回值。

实际项目里我更倾向把两种方式放在一起，封装一个带取消和序号校验的 hook：

```tsx
function useFetchData<T>(url: string) {
 const [data, setData] = useState<T | null>(null);
 const [loading, setLoading] = useState(false);
 const [error, setError] = useState<Error | null>(null);

 useEffect(() => {
 const controller = new AbortController();
 let alive = true;

 setLoading(true);
 setError(null);

 fetch(url, { signal: controller.signal })
 .then((res) => {
 if (!res.ok) throw new Error(`HTTP ${res.status}`);
 return res.json();
 })
 .then((json) => {
 if (alive) setData(json);
 })
 .catch((err) => {
 if (err.name === 'AbortError') return;
 if (alive) setError(err);
 })
 .finally(() => {
 if (alive) setLoading(false);
 });

 return () => {
 alive = false;
 controller.abort();
 };
 }, [url]);

 return { data, loading, error };
}
```

这里 `alive` 标志和 abort 同时存在看起来有点冗余，但实际很有用：abort 依赖请求库正确抛出 `AbortError`，而 `alive` 是纯 JS 层面的保证，组件卸载后无论如何都不会再 `setState`，避免 React 在开发环境给出的 “Can't perform a state update on an unmounted component” 警告。 

还有一个容易忽略的点是依赖数组。很多重复请求其实是依赖写错了，比如把每次渲染都会新建的对象或函数放进依赖里：

```tsx
// 每次渲染 options 都是新对象，effect 就会一直重跑
const options = { page: 1, size: 20 };
useEffect(() => { load(options); }, [options]);
```

这种要么用 `useMemo` 稳定引用，要么把原始值拆开作为依赖。StrictMode 的双调用本身不是 bug，它是在逼你把 effect 写成幂等且可清理的形式，清理函数写对了，双调用自然就不会造成重复请求的副作用。 

如果项目里用了 TanStack Query 这类数据请求库，上面这些基本都不用自己写，它内部已经处理了取消、竞态和缓存。但如果是在维护老项目，或者只是简单页面不想引额外依赖，上面这套 `AbortController` 加 `alive` 标志的组合已经够用了。升级 React 18 时建议先在开发环境把 StrictMode 打开跑一遍，把所有 effect 的清理逻辑补齐，比线上偶发数据错乱后再回头查要省事得多。

 推荐查看组词：http://www.ttctq.com/zuci/6243.html
 推荐查看组词：http://www.ttctq.com/zuci/6244.html
 推荐查看组词：http://www.ttctq.com/zuci/6245.html
 推荐查看组词：http://www.ttctq.com/zuci/6246.html
 推荐查看组词：http://www.ttctq.com/zuci/6247.html
 推荐查看组词：http://www.ttctq.com/zuci/6248.html
 推荐查看组词：http://www.ttctq.com/zuci/6249.html
 推荐查看组词：http://www.ttctq.com/zuci/6250.html
 推荐查看组词：http://www.ttctq.com/zuci/6251.html
 推荐查看组词：http://www.ttctq.com/zuci/6252.html
 推荐查看组词：http://www.ttctq.com/zuci/6253.html
 推荐查看组词：http://www.ttctq.com/zuci/6254.html
 推荐查看组词：http://www.ttctq.com/zuci/6255.html
 推荐查看组词：http://www.ttctq.com/zuci/6256.html
 推荐查看组词：http://www.ttctq.com/zuci/6257.html
 推荐查看组词：http://www.ttctq.com/zuci/6258.html
 推荐查看组词：http://www.ttctq.com/zuci/6259.html
 推荐查看组词：http://www.ttctq.com/zuci/6260.html
 推荐查看组词：http://www.ttctq.com/zuci/6261.html
 推荐查看组词：http://www.ttctq.com/zuci/6262.html
 推荐查看组词：http://www.ttctq.com/zuci/6263.html
 推荐查看组词：http://www.ttctq.com/zuci/6264.html
 推荐查看组词：http://www.ttctq.com/zuci/6265.html
 推荐查看组词：http://www.ttctq.com/zuci/6266.html
 推荐查看组词：http://www.ttctq.com/zuci/6267.html
 推荐查看组词：http://www.ttctq.com/zuci/6268.html
 推荐查看组词：http://www.ttctq.com/zuci/6269.html
 推荐查看组词：http://www.ttctq.com/zuci/6270.html
 推荐查看组词：http://www.ttctq.com/zuci/6271.html
 推荐查看组词：http://www.ttctq.com/zuci/6272.html
 推荐查看组词：http://www.ttctq.com/zuci/6273.html
 推荐查看组词：http://www.ttctq.com/zuci/6274.html
 推荐查看组词：http://www.ttctq.com/zuci/6275.html
 推荐查看组词：http://www.ttctq.com/zuci/6276.html
 推荐查看组词：http://www.ttctq.com/zuci/6277.html
 推荐查看组词：http://www.ttctq.com/zuci/6278.html
 推荐查看组词：http://www.ttctq.com/zuci/6279.html
 推荐查看组词：http://www.ttctq.com/zuci/6280.html
 推荐查看组词：http://www.ttctq.com/zuci/6281.html
 推荐查看组词：http://www.ttctq.com/zuci/6282.html
 推荐查看组词：http://www.ttctq.com/zuci/6283.html
 推荐查看组词：http://www.ttctq.com/zuci/6284.html
 推荐查看组词：http://www.ttctq.com/zuci/6285.html
 推荐查看组词：http://www.ttctq.com/zuci/6286.html
 推荐查看组词：http://www.ttctq.com/zuci/6287.html
 推荐查看组词：http://www.ttctq.com/zuci/6288.html
 推荐查看组词：http://www.ttctq.com/zuci/6289.html
 推荐查看组词：http://www.ttctq.com/zuci/6290.html
 推荐查看组词：http://www.ttctq.com/zuci/6291.html
 推荐查看组词：http://www.ttctq.com/zuci/6292.html
 推荐查看组词：http://www.ttctq.com/zuci/6293.html
 推荐查看组词：http://www.ttctq.com/zuci/6294.html
 推荐查看组词：http://www.ttctq.com/zuci/6295.html
 推荐查看组词：http://www.ttctq.com/zuci/6296.html
 推荐查看组词：http://www.ttctq.com/zuci/6297.html
 推荐查看组词：http://www.ttctq.com/zuci/6298.html
 推荐查看组词：http://www.ttctq.com/zuci/6299.html
 推荐查看组词：http://www.ttctq.com/zuci/6300.html
 推荐查看组词：http://www.ttctq.com/zuci/6301.html
 推荐查看组词：http://www.ttctq.com/zuci/6302.html
 推荐查看组词：http://www.ttctq.com/zuci/6303.html
 推荐查看组词：http://www.ttctq.com/zuci/6304.html
 推荐查看组词：http://www.ttctq.com/zuci/6305.html
 推荐查看组词：http://www.ttctq.com/zuci/6306.html
 推荐查看组词：http://www.ttctq.com/zuci/6307.html
 推荐查看组词：http://www.ttctq.com/zuci/6308.html
 推荐查看组词：http://www.ttctq.com/zuci/6309.html
 推荐查看组词：http://www.ttctq.com/zuci/6310.html
 推荐查看组词：http://www.ttctq.com/zuci/6311.html
 推荐查看组词：http://www.ttctq.com/zuci/6312.html
 推荐查看组词：http://www.ttctq.com/zuci/6313.html
 推荐查看组词：http://www.ttctq.com/zuci/6314.html
 推荐查看组词：http://www.ttctq.com/zuci/6315.html
 推荐查看组词：http://www.ttctq.com/zuci/6316.html
 推荐查看组词：http://www.ttctq.com/zuci/6317.html
 推荐查看组词：http://www.ttctq.com/zuci/6318.html
 推荐查看组词：http://www.ttctq.com/zuci/6319.html
 推荐查看组词：http://www.ttctq.com/zuci/6320.html
 推荐查看组词：http://www.ttctq.com/zuci/6321.html
 推荐查看组词：http://www.ttctq.com/zuci/6322.html
 推荐查看组词：http://www.ttctq.com/zuci/6323.html
 推荐查看组词：http://www.ttctq.com/zuci/6324.html
 推荐查看组词：http://www.ttctq.com/zuci/6325.html
 推荐查看组词：http://www.ttctq.com/zuci/6326.html
 推荐查看组词：http://www.ttctq.com/zuci/6327.html
 推荐查看组词：http://www.ttctq.com/zuci/6328.html
 推荐查看组词：http://www.ttctq.com/zuci/6329.html
 推荐查看组词：http://www.ttctq.com/zuci/6330.html
 推荐查看组词：http://www.ttctq.com/zuci/6331.html
 推荐查看组词：http://www.ttctq.com/zuci/6332.html
 推荐查看组词：http://www.ttctq.com/zuci/6333.html
 推荐查看组词：http://www.ttctq.com/zuci/6334.html
 推荐查看组词：http://www.ttctq.com/zuci/6335.html
 推荐查看组词：http://www.ttctq.com/zuci/6336.html
 推荐查看组词：http://www.ttctq.com/zuci/6337.html
 推荐查看组词：http://www.ttctq.com/zuci/6338.html
 推荐查看组词：http://www.ttctq.com/zuci/6339.html
 推荐查看组词：http://www.ttctq.com/zuci/6340.html
 推荐查看组词：http://www.ttctq.com/zuci/6341.html
 推荐查看组词：http://www.ttctq.com/zuci/6342.html
 推荐查看组词：http://www.ttctq.com/zuci/6343.html
 推荐查看组词：http://www.ttctq.com/zuci/6344.html
 推荐查看组词：http://www.ttctq.com/zuci/6345.html
 推荐查看组词：http://www.ttctq.com/zuci/6346.html
 推荐查看组词：http://www.ttctq.com/zuci/6347.html
 推荐查看组词：http://www.ttctq.com/zuci/6348.html
 推荐查看组词：http://www.ttctq.com/zuci/6349.html
 推荐查看组词：http://www.ttctq.com/zuci/6350.html
 推荐查看组词：http://www.ttctq.com/zuci/6351.html
 推荐查看组词：http://www.ttctq.com/zuci/6352.html
 推荐查看组词：http://www.ttctq.com/zuci/6353.html
 推荐查看组词：http://www.ttctq.com/zuci/6354.html
 推荐查看组词：http://www.ttctq.com/zuci/6355.html
 推荐查看组词：http://www.ttctq.com/zuci/6356.html
 推荐查看组词：http://www.ttctq.com/zuci/6357.html
 推荐查看组词：http://www.ttctq.com/zuci/6358.html
 推荐查看组词：http://www.ttctq.com/zuci/6359.html
 推荐查看组词：http://www.ttctq.com/zuci/6360.html
 推荐查看组词：http://www.ttctq.com/zuci/6361.html
 推荐查看组词：http://www.ttctq.com/zuci/6362.html
 推荐查看组词：http://www.ttctq.com/zuci/6363.html
 推荐查看组词：http://www.ttctq.com/zuci/6364.html
 推荐查看组词：http://www.ttctq.com/zuci/6365.html
 推荐查看组词：http://www.ttctq.com/zuci/6366.html
 推荐查看组词：http://www.ttctq.com/zuci/6367.html
 推荐查看组词：http://www.ttctq.com/zuci/6368.html
 推荐查看组词：http://www.ttctq.com/zuci/6369.html
 推荐查看组词：http://www.ttctq.com/zuci/6370.html
 推荐查看组词：http://www.ttctq.com/zuci/6371.html
 推荐查看组词：http://www.ttctq.com/zuci/6372.html
 推荐查看组词：http://www.ttctq.com/zuci/6373.html
 推荐查看组词：http://www.ttctq.com/zuci/6374.html
 推荐查看组词：http://www.ttctq.com/zuci/6375.html
 推荐查看组词：http://www.ttctq.com/zuci/6376.html
 推荐查看组词：http://www.ttctq.com/zuci/6377.html
 推荐查看组词：http://www.ttctq.com/zuci/6378.html
 推荐查看组词：http://www.ttctq.com/zuci/6379.html
 推荐查看组词：http://www.ttctq.com/zuci/6380.html
 推荐查看组词：http://www.ttctq.com/zuci/6381.html
 推荐查看组词：http://www.ttctq.com/zuci/6382.html
 推荐查看组词：http://www.ttctq.com/zuci/6383.html
 推荐查看组词：http://www.ttctq.com/zuci/6384.html
 推荐查看组词：http://www.ttctq.com/zuci/6385.html
 推荐查看组词：http://www.ttctq.com/zuci/6386.html
 推荐查看组词：http://www.ttctq.com/zuci/6387.html
 推荐查看组词：http://www.ttctq.com/zuci/6388.html
 推荐查看组词：http://www.ttctq.com/zuci/6389.html
 推荐查看组词：http://www.ttctq.com/zuci/6390.html
 推荐查看组词：http://www.ttctq.com/zuci/6391.html
 推荐查看组词：http://www.ttctq.com/zuci/6392.html
 推荐查看组词：http://www.ttctq.com/zuci/6393.html
 推荐查看组词：http://www.ttctq.com/zuci/6394.html
 推荐查看组词：http://www.ttctq.com/zuci/6395.html
 推荐查看组词：http://www.ttctq.com/zuci/6396.html
 推荐查看组词：http://www.ttctq.com/zuci/6397.html
 推荐查看组词：http://www.ttctq.com/zuci/6398.html
 推荐查看组词：http://www.ttctq.com/zuci/6399.html
 推荐查看组词：http://www.ttctq.com/zuci/6400.html
 推荐查看组词：http://www.ttctq.com/zuci/6401.html
 推荐查看组词：http://www.ttctq.com/zuci/6402.html
 推荐查看组词：http://www.ttctq.com/zuci/6403.html
 推荐查看组词：http://www.ttctq.com/zuci/6404.html
 推荐查看组词：http://www.ttctq.com/zuci/6405.html
 推荐查看组词：http://www.ttctq.com/zuci/6406.html
 推荐查看组词：http://www.ttctq.com/zuci/6407.html
 推荐查看组词：http://www.ttctq.com/zuci/6408.html
 推荐查看组词：http://www.ttctq.com/zuci/6409.html
 推荐查看组词：http://www.ttctq.com/zuci/6410.html
 推荐查看组词：http://www.ttctq.com/zuci/6411.html
 推荐查看组词：http://www.ttctq.com/zuci/6412.html
 推荐查看组词：http://www.ttctq.com/zuci/6413.html
 推荐查看组词：http://www.ttctq.com/zuci/6414.html
 推荐查看组词：http://www.ttctq.com/zuci/6415.html
 推荐查看组词：http://www.ttctq.com/zuci/6416.html
 推荐查看组词：http://www.ttctq.com/zuci/6417.html
 推荐查看组词：http://www.ttctq.com/zuci/6418.html
 推荐查看组词：http://www.ttctq.com/zuci/6419.html
 推荐查看组词：http://www.ttctq.com/zuci/6420.html
 推荐查看组词：http://www.ttctq.com/zuci/6421.html
 推荐查看组词：http://www.ttctq.com/zuci/6422.html
 推荐查看组词：http://www.ttctq.com/zuci/6423.html
 推荐查看组词：http://www.ttctq.com/zuci/6424.html
 推荐查看组词：http://www.ttctq.com/zuci/6425.html
 推荐查看组词：http://www.ttctq.com/zuci/6426.html
 推荐查看组词：http://www.ttctq.com/zuci/6427.html
 推荐查看组词：http://www.ttctq.com/zuci/6428.html
 推荐查看组词：http://www.ttctq.com/zuci/6429.html
 推荐查看组词：http://www.ttctq.com/zuci/6430.html
 推荐查看组词：http://www.ttctq.com/zuci/6431.html
 推荐查看组词：http://www.ttctq.com/zuci/6432.html
 推荐查看组词：http://www.ttctq.com/zuci/6433.html
 推荐查看组词：http://www.ttctq.com/zuci/6434.html
 推荐查看组词：http://www.ttctq.com/zuci/6435.html
 推荐查看组词：http://www.ttctq.com/zuci/6436.html
 推荐查看组词：http://www.ttctq.com/zuci/6437.html
 推荐查看组词：http://www.ttctq.com/zuci/6438.html
 推荐查看组词：http://www.ttctq.com/zuci/6439.html
 推荐查看组词：http://www.ttctq.com/zuci/6440.html
 推荐查看组词：http://www.ttctq.com/zuci/6441.html
 推荐查看组词：http://www.ttctq.com/zuci/6442.html

最近在把一个后台管理项目从 React 17 升到 18，开启 createRoot 之后，列表页的请求偶尔会发两次，详情页在快速切换时还会出现旧数据覆盖新数据的情况。排查下来并不是接口本身的问题，而是并发渲染特性让组件的挂载和副作用执行时机变得更“激进”，尤其是在 StrictMode 下开发环境会刻意双调用 effect 来帮助暴露副作用清理不彻底的问题。另外，用户在搜索框连续输入、或者从列表快速点进不同详情页时，多个异步请求的返回顺序并不保证，先发的请求可能后回来，直接把后发请求的结果覆盖掉。这篇文章结合真实的组件代码，梳理 effect 重复执行的原因、清理函数的正确写法，以及用请求取消和请求序号两种手段解决竞态，最后给出一套可复用的数据请求 hook 写法。

React 18 并发渲染下 useEffect 重复执行与竞态请求的实战处理

最近在把一个后台管理项目从 React 17 升到 18，开启 createRoot 之后，列表页的请求偶尔会发两次，详情页在快速切换时还会出现旧数据覆盖新数据的情况。排查下来并不是接口本身的问题，而是并发渲染特性让组件的挂载和副作用执行时机变得更“激进”，尤其是在 StrictMode 下开发环境会刻意双调用 effect 来帮助暴露副作用清理不彻底的问题。另外，用户在搜索框连续输入、或者从列表

前端

编程语言

React 18 升级后请求竞态与重复发送问题解析：深入 useEffect 清理机制、AbortController 取消请求及请求序号防覆盖方案，提供完整 useFetchData 数据请求 Hook 封装，解决并发渲染导致的旧数据覆盖新数据问题。

代码解释

ReAct 

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

React 18 并发渲染下 useEffect 重复执行与竞态请求的实战处理-腾讯云开发者社区-腾讯云

React 18 并发渲染下 useEffect 重复执行与竞态请求的实战处理

React 18 并发渲染下 useEffect 重复执行与竞态请求的实战处理

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐