useEffect 重复执行,先要分清是哪一种:是开发期 StrictMode 的两次调用,是依赖引用每次渲染都变导致 effect 每次都重跑,还是 effect 里无条件 setState 又触发渲染形成循环。三种原因的处理方式不同,直接给依赖数组补一个空数组,通常只是把「跑太多次」换成「拿到旧值」,问题会换个形式出现。
判断顺序建议是:先在开发环境确认是否开启了 StrictMode,再用日志比对依赖项引用是否变化,最后检查 effect 内部有没有引发新一轮渲染的 setState 或请求。适用场景是函数组件中用 useEffect 做请求、订阅、定时器;操作上优先稳定依赖引用、补齐 cleanup,其次才考虑 ref 保存最新回调;验证方式是在依赖不变时多次 re-render,观察 effect 是否仍被触发;边界是空依赖数组会锁死首次渲染的闭包变量,不适合依赖会变的场景。
先确认当前场景和目标
先回答三个问题,基本能定位到具体类别。
- 重复执行发生在开发环境还是构建后的产物里。React 18 起,开发环境 StrictMode 会故意挂载—卸载—再挂载一次组件,effect 在挂载阶段执行两次属于预期行为;生产构建里不会这样。如果只在本地 dev 出现、打包后正常,通常不需要「修」。
- 依赖数组里的值是不是对象、数组或函数。这类值每次渲染都会生成新引用,
Object.is比较必然不相等,effect 就会每次渲染后都跑一遍。 - effect 内部是否调用了 setState 或改了会影响自身的状态。如果 setState 写入的值每次都不一样(比如新建对象、Date.now()),就会形成「渲染 → effect → setState → 渲染」的循环。
另外要确认目标是哪一个:是希望「依赖不变时不要重跑」,还是希望「重跑时不要重复发请求」,还是希望「卸载后不要再执行回调」。目标不同,改法也不同。
按这个顺序处理
第一步,先看依赖到底变没变。不要在 effect 里直接 console.log 整个依赖数组,那样只能看到值,看不出是哪一个变了。可以先用一个临时 hook 打印变化项,定位后再删掉。
import { useEffect, useRef } from 'react';
function useWhyChanged(deps, label = 'effect') {
const prev = useRef(deps);
useEffect(() => {
deps.forEach((dep, i) => {
if (!Object.is(dep, prev.current[i])) {
console.log([${label}] dep[${i}] changed, prev.current[i], '->', dep);
}
});
prev.current = deps;
}, deps);
}
// 使用处
useWhyChanged([userId, filter], 'fetchList');
如果日志显示每次渲染都有某个对象或函数被判定为变化,问题就落在引用稳定性上,进入第二步;如果依赖完全没变但 effect 仍然执行,就要往 StrictMode 和父组件重新挂载方向查。
第二步,把对象依赖拆成原始值。这是改动成本最低、副作用最小的一种做法。下面这段是可以替换的通用写法:
// 改动前:filter 是父组件传下来的对象,每次渲染新建
useEffect(() => {
fetchList({ page, size: filter.size, keyword: filter.keyword });
}, [page, filter]);
// 改动后:依赖只保留原始值,对象在 effect 内部组装
useEffect(() => {
fetchList({ page, size, keyword });
}, [page, size, keyword]);
如果对象来自父组件且确实需要整体传递,可以在父组件用 useMemo 包一层,或者把这段逻辑下沉到子组件内部,避免把不稳定引用跨层传下来。

第三步,给订阅和定时器补 cleanup。很多「重复执行」实际上不是 effect 跑多了,而是上一次的定时器、事件监听、WebSocket 订阅没有清掉,表现为回调触发次数越来越多。
useEffect(() => {
const id = setInterval(() => {
// 轮询逻辑
}, 5000);
const onResize = () => { /* ... */ };
window.addEventListener('resize', onResize);
return () => {
clearInterval(id);
window.removeEventListener('resize', onResize);
};
}, []);
第四步,确实需要「只跑一次但要读最新值」时,用 ref 保存回调。不要为了少跑几次就把依赖写成空数组,否则闭包里拿到的是首次渲染的值。常见做法是把最新回调放进 ref,effect 里只调用 ref 上的函数:
import { useEffect, useRef } from 'react';
function useInterval(callback, delay) {
const saved = useRef(callback);
useEffect(() => {
saved.current = callback;
});
useEffect(() => {
if (delay == null) return;
const id = setInterval(() => saved.current(), delay);
return () => clearInterval(id);
}, [delay]);
}
第五步,如果 effect 里发了请求,补上取消或序号判断。依赖控制解决的是「少触发」,但切换页面、快速改参数时仍可能有旧请求返回。用 AbortController 或递增的请求编号做兜底,比单纯调依赖更稳。
改完后怎么验证
验证要分环境和分动作,不要只看一次控制台输出。
- 在 effect 首行加一个带标签的计数(例如
console.count('fetchList-effect')),刷新页面观察开发环境的执行次数。开启 StrictMode 时挂载阶段出现两次属于预期,不要把它当成 bug 继续改。 - 用构建后的产物再跑一遍同样的操作,确认生产环境下依赖不变时 effect 不再重复执行。开发和生产表现不一致,基本可以排除业务逻辑问题。
- 把第一步的
useWhyChanged保留到验证结束,手动触发父组件重渲染(比如输入框连续输入、切换 tab),观察是否还有非预期的依赖变化日志。 - 在浏览器 Network 面板按请求计数,代替看日志。连续修改筛选条件、来回切换路由,确认同一份参数只发一次请求,离开页面后没有继续发出的请求。
- 卸载验证:进入带订阅的页面再离开,观察定时器回调、事件监听是否停止。预期信号是组件卸载后不再有新的回调输出,且重复进出页面时监听数量不累积。
如果上述动作里只有「开发环境两次、生产环境一次」,说明是 StrictMode 行为,处理动作应该是记录并忽略,而不是改依赖。
容易忽略的边界
- StrictMode 的双调用只在开发环境出现。处理方式不是删掉 StrictMode,也不是把依赖改成空数组来「骗过」它,而是确认 effect 有正确的 cleanup,能在重复挂载下自洽。
- 空依赖数组会固定首次渲染的闭包。如果 effect 里读取了 props 或 state,后续更新不会反映进去,表现为「数据不刷新」而不是报错,排查成本反而更高。依赖确实需要「不重跑但读最新值」时,走 ref 模式。
- 父组件未 memo 是常见源头。即使子组件自己的依赖写得很干净,只要父组件每次渲染都新建对象、数组、内联函数并作为 props 传入,引用依旧每次变化。需要结合父组件的渲染次数一起看。
- 版本差异要确认。React 17 及更早版本没有 StrictMode 重复挂载行为,此时出现重复执行基本是依赖或循环问题;React 18 之后还要区分并发特性带来的渲染次数变化,不要一律归因到依赖。
- 回退建议。改动依赖数组前先提交一次,方便对比。如果改完后出现取到旧值、请求参数滞后的问题,回退到原依赖写法,改用 ref 保存最新回调或拆分子组件的方式处理,不要继续在依赖数组上做减法。