react如何解决 Hooks 闭包陷阱

React Hooks 的"闭包陷阱(stale closure)"本质是:函数拿到的是创建时那一刻的 state/props,而不是最新值 。常见出现在 setTimeout、setInterval、事件监听、异步请求、useEffect 中。

例如:

javascript 复制代码
import { useState } from 'react';

export default function Demo() {
  const [count, setCount] = useState(0);

  const handleClick = () => {
    setTimeout(() => {
      console.log(count); // 永远打印点击时的 count
    }, 3000);
  };

  return (
    <>
      <button onClick={() => setCount(count + 1)}>
        +1
      </button>

      <button onClick={handleClick}>
        延迟打印
      </button>
    </>
  );
}

假设:

ini 复制代码
count = 0
点击延迟打印
马上点击 +1 -> count=1
3秒后输出:0

因为 setTimeout 闭包保存的是旧 count。


解决方案1:函数式更新(推荐处理 state 更新)

适合依赖旧值计算新值。

错误:

scss 复制代码
setCount(count + 1);
setCount(count + 1);

console.log(count); // +1

正确:

ini 复制代码
setCount(prev => prev + 1);
setCount(prev => prev + 1);

console.log(count); // +2

React 会拿最新状态:

ini 复制代码
setInterval(() => {
   setCount(prev => prev + 1);
},1000);

避免:

scss 复制代码
setCount(count + 1); // count 永远旧

解决方案2:useRef 保存最新值(最常见)

适合:

  • setTimeout
  • setInterval
  • websocket
  • 原生事件
  • 防抖节流

例子:

javascript 复制代码
import { useRef, useState, useEffect } from 'react';

export default function Demo() {
  const [count, setCount] = useState(0);

  const countRef = useRef(count);

  useEffect(() => {
    countRef.current = count;
  }, [count]);

  const handleClick = () => {
    setTimeout(() => {
      console.log(countRef.current);
    }, 3000);
  };

  return (
      <>
          <button onClick={() => setCount(count+1)}>
             +1
          </button>

          <button onClick={handleClick}>
             打印
          </button>
      </>
  );
}

始终输出最新值。

原理:

rust 复制代码
闭包 -> 拿不到最新 state
ref.current -> 永远最新

很多库(例如防抖 hooks)都这么做。


解决方案3:正确维护 useEffect 依赖

错误:

scss 复制代码
useEffect(() => {
   getData(id);
}, []);

即使 id 变化也不会重新执行。

应写:

scss 复制代码
useEffect(() => {
   getData(id);
}, [id]);

遵守 eslint:

bash 复制代码
react-hooks/exhaustive-deps

不要随便关:

arduino 复制代码
// eslint-disable-next-line

很多闭包问题来自错误依赖。


解决方案4:useCallback + 依赖更新

错误:

ini 复制代码
const getUser = useCallback(() => {
    console.log(id);
}, []);

id 永远旧。

正确:

ini 复制代码
const getUser = useCallback(() => {
    console.log(id);
}, [id]);

解决方案5:抽离自定义 Hook(推荐业务场景)

比如轮询:

错误:

scss 复制代码
useEffect(() => {
   const timer=setInterval(()=>{
      fetchData(page);
   },1000)

   return ()=>clearInterval(timer)
},[])

page 永远旧。

改:

ini 复制代码
function useLatest(value){
   const ref=useRef(value);

   useEffect(()=>{
      ref.current=value;
   },[value])

   return ref;
}

使用:

scss 复制代码
const pageRef = useLatest(page);

useEffect(() => {
   const timer = setInterval(() => {
      fetchData(pageRef.current);
   },1000);

   return ()=>clearInterval(timer);
},[])

解决方案6:React 19 的 useEffectEvent(未来推荐)

React 提供了解决闭包问题的新方案:

javascript 复制代码
const onVisit = useEffectEvent(() => {
   console.log(count);
});

useEffect(()=>{
   window.addEventListener('click',onVisit)

   return ()=>{
      window.removeEventListener('click',onVisit)
   }
},[])

事件始终读取最新 state。

适合:

  • 订阅
  • 监听器
  • effect 内回调

前端开发里可以记一个经验:

bash 复制代码
需要最新状态:
→ 用 ref

依赖旧状态更新:
→ 用函数式 setState

effect/callback 使用变量:
→ 补全依赖数组

长生命周期回调:
→ useLatest / useRef

React19:
→ useEffectEvent

像你做性能平台、轮询二维码状态、下载任务进度这些场景,setInterval + useRef 基本是闭包问题高发区。

相关推荐
feixing_fx4 分钟前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
Highcharts.js4 小时前
Highcharts与TypeScript集成指南
前端·javascript·typescript·前端框架·数据可视化·highcharts
feixing_fx18 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx19 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
feixing_fx1 天前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
用户298698530141 天前
React 前端实现 Word 与 OpenXML 双向转换的完整实践
javascript·react.js
月夏2 天前
我把全栈项目塞进已有 nginx 的服务器,卡我最久的是三个斜杠
nginx·react.js·docker
feixing_fx3 天前
CSS 变量(Custom Properties):构建可扩展的主题切换系统
前端·css·前端框架·html·css3
清晨Coding5 天前
为什么用 React Developer Tools 查看组件树这么乱?
前端·react.js
生活的囚徒6 天前
从一堆Excel到一套系统:项目管理+研发管理双门户的落地实践
react.js