Skip to content

事件处理器使用闭包中的过期状态

快速摘要

你的 onClick 或 onChange 处理器读取创建处理器时捕获的状态 —— 它看不到最新状态值。

为什么发生

  • 处理器在 JSX 中内联定义并读取变化的状态,但闭包捕获渲染时的值

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

  • 存储在 ref 或变量中的处理器捕获更早渲染的状态并在稍后调用

最小示例

✗ 错误代码
function Counter() {
  const [count, setCount] = useState(0);
  const handleClick = useCallback(() => {
    console.log(count); // stale!
    setCount(count + 1);
  }, []); // count not in deps
  return <button onClick={handleClick}>{count}</button>;
}
✓ 修复代码
function Counter() {
  const [count, setCount] = useState(0);
  const handleClick = useCallback(() => {
    setCount(prev => prev + 1); // functional update
  }, []); // no deps needed
  return <button onClick={handleClick}>{count}</button>;
}

使用函数式更新避免从闭包读取过期 count,处理器始终正确递增。

如何诊断

  • 在处理器内记录状态值并与 UI 中显示的当前状态比较

  • 检查处理器是否每次渲染重建或用过期依赖记忆

  • 使用 React DevTools 检查处理器闭包并验证它捕获的状态值

如何修复

  • 使用函数式状态更新:setCount(prev => prev + 1) 避免在处理器中读取过期状态

  • 将处理器读取的所有状态加入 useCallback 依赖数组使其用新值重建

  • 将最新状态存储在 ref 中并在处理器中读取 ref.current 始终访问当前值

如何预防

  • 在事件处理器中优先使用函数式状态更新而非直接读取状态

  • 在 useCallback/useEffect 数组中包含所有依赖并使用 exhaustive-deps eslint 规则

相关资源

相关术语

相关课程

← 返回语言