状态更新批处理导致 UI 过期
快速摘要
你在同一事件处理器中多次调用 setState 并在调用间读取状态 —— React 批处理更新,中间读取是过期的。
为什么发生
你在 setState 后的同一事件处理器中读取状态,但 React 尚未重渲染
多次 setState 调用批处理为一次渲染,状态变量在调用间仍持有旧值
你期望每个 setState 立即更新状态变量,但更新是异步且批处理的
最小示例
✗ 错误代码
function handleClick() {
setCount(count + 1);
console.log(count); // stale!
setCount(count + 1); // adds 1 to old count, not new count
}✓ 修复代码
function handleClick() {
setCount(prev => prev + 1);
setCount(prev => prev + 1); // correctly adds 2 total
}
// Or: setCount(count + 2);函数式更新接收最新状态作为参数,即使批处理时每次更新也基于前一次。
如何诊断
在 setState 后立即记录状态值,确认仍显示旧值
检查是否在更新状态的同一处理器中读取状态 —— 重渲染前值是过期的
使用 React DevTools 查看批处理更新和处理器完成后的最终状态
如何修复
使用函数式更新链接状态变化:setCount(prev => prev + 1) 而非 setCount(count + 1)
在调用 setState 前本地计算新值:const newCount = count + 1; setCount(newCount);
使用单一状态对象或 useReducer 原子性地更新多个相关值
如何预防
永远不要在同一处理器中 setState 后立即读取状态 —— 使用函数式更新或本地变量
对涉及多个相关更新的复杂状态逻辑使用 useReducer