事件处理器中的 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 的依赖数组中