事件处理器使用闭包中的过期状态
快速摘要
你的 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 规则