Skip to content

事件处理器中的 useState 过期闭包

快速摘要

你的事件处理器读取了创建它的渲染中的过期状态值 —— 闭包捕获了旧状态而非当前状态。

为什么发生

  • 事件处理器在某个渲染周期中定义,捕获了该渲染的状态值,而非最新值

  • 你在 setTimeout 或 setInterval 回调中直接使用 useState 的值,该回调在更早的渲染中设置

  • 处理器用 useCallback 记忆但依赖数组未包含它读取的状态

最小示例

✗ 错误代码
function Counter() {
  const [count, setCount] = useState(0);
  useEffect(() => {
    const id = setInterval(() => {
      setCount(count + 1); // stale closure!
    }, 1000);
    return () => clearInterval(id);
  }, []); // count not in deps
}
✓ 修复代码
function Counter() {
  const [count, setCount] = useState(0);
  useEffect(() => {
    const id = setInterval(() => {
      setCount(prev => prev + 1); // functional update
    }, 1000);
    return () => clearInterval(id);
  }, []); // no deps needed
}

使用函数式更新(prev => prev + 1)始终读取最新状态值,完全避免过期闭包问题。

如何诊断

  • 在处理器内记录状态值,确认显示的是旧值而非当前值

  • 检查处理器是否每次渲染重建或记忆时缺少依赖

  • 用 ref 追踪最新状态并与捕获值比较以检测过期

如何修复

  • 使用函数式状态更新:setCount(prev => prev + 1) 而非 setCount(count + 1) 始终使用最新值

  • 将状态变量加入 useCallback 或 useEffect 的依赖数组,使处理器用新值重建

  • 用 ref(useRef)存储最新状态,在处理器中读取 ref.current 始终访问当前值

如何预防

  • 对依赖前值的更新始终使用函数式更新:setX(prev => newValue)

  • 将处理器读取的所有变量包含在 useCallback 或 useEffect 的依赖数组中

相关资源

相关术语

相关课程

← 返回语言