React Hooks 闭包陷阱:状态“丢失“的经典坑

一、问题现象

在 React 函数组件中,事件回调函数里获取的状态值不是最新值,而是初始值或旧值。

ts 复制代码
const [count, setCount] = useState(0);

// 点击按钮时,期望打印最新值,实际却打印旧值
const handleClick = () => {
  console.log(count);  // 可能不是最新值!
};

二、根因分析

2.1 闭包的基本特性

JavaScript 闭包会捕获定义时的变量值:

ts 复制代码
function createClosure() {
  let value = 0;
  
  return {
    getValue: () => value,  // 捕获 value 的引用
    setValue: (v) => { value = v; }
  };
}

const closure = createClosure();
closure.setValue(10);
console.log(closure.getValue());  // 10 ✅ 正常工作

2.2 React 组件的特殊情况

React 函数组件每次渲染都会创建新的函数作用域:

ts 复制代码
// 第一次渲染
function MyComponent() {
  const [count, setCount] = useState(0);
  
  // 这次渲染时,count = 0
  const handleClick = () => {
    console.log(count);  // 捕获 count = 0
  };
  
  return <button onClick={handleClick}>Click</button>;
}

// 第二次渲染(setCount(1) 后)
function MyComponent() {
  const [count, setCount] = useState(1);
  
  // 这次渲染时,count = 1
  // 但是!如果 handleClick 没有重新创建
  // 它仍然是旧的,捕获着 count = 0
}

2.3 问题示意

三、典型场景

场景 1:useEffect 依赖数组缺失

ts 复制代码
// ❌ 错误示例
useEffect(() => {
  const timer = setInterval(() => {
    console.log(count);  // 永远是 0
  }, 1000);
  return () => clearInterval(timer);
}, []);  // 缺少 count 依赖

// ✅ 正确写法
useEffect(() => {
  const timer = setInterval(() => {
    console.log(count);
  }, 1000);
  return () => clearInterval(timer);
}, [count]);  // 添加 count 依赖

场景 2:事件回调未更新

ts 复制代码
// ❌ 错误示例
const handleClick = useRef(() => {
  console.log(data);  // 捕获旧的 data
}).current;

// ✅ 正确写法 1:使用 useCallback
const handleClick = useCallback(() => {
  console.log(data);
}, [data]);  // 依赖变化时重新创建

// ✅ 正确写法 2:使用 useRef 同步最新值
const dataRef = useRef(data);
useEffect(() => {
  dataRef.current = data;
}, [data]);

const handleClick = () => {
  console.log(dataRef.current);  // 始终是最新的
};

场景 3:异步操作中的状态

ts 复制代码
// ❌ 错误示例
const handleAsync = () => {
  fetchData().then(() => {
    console.log(items);  // 可能是旧值
  });
};

// ✅ 正确写法 1:使用 useRef
const itemsRef = useRef(items);
useEffect(() => {
  itemsRef.current = items;
}, [items]);

const handleAsync = () => {
  fetchData().then(() => {
    console.log(itemsRef.current);  // 始终是最新的
  });
};

// ✅ 正确写法 2:使用函数式更新
const handleAsync = () => {
  fetchData().then(() => {
    setItems(prev => {
      console.log(prev);  // 获取最新值
      return prev;
    });
  });
};

四、解决方案对比

方案 适用场景 优点 缺点
添加依赖 简单场景 直观简单 可能导致频繁重建
useCallback 事件处理 性能可控 需要维护依赖数组
useRef 同步 复杂状态 避免重建 需要额外同步逻辑
函数式更新 状态更新场景 无需额外依赖 仅适用于 setState

五、最佳实践

选择正确的策略

代码示例

ts 复制代码
// ✅ 推荐:综合使用多种策略
function useLatestValue<T>(value: T) {
  const ref = useRef(value);
  useEffect(() => {
    ref.current = value;
  }, [value]);
  return ref;
}

// 使用示例
function MyComponent() {
  const [data, setData] = useState([]);
  const dataRef = useLatestValue(data);
  
  const handleEvent = useCallback(() => {
    // 使用 ref 获取最新值
    console.log(dataRef.current);
  }, []);  // 依赖数组可以为空
  
  return <div onClick={handleEvent}>Click</div>;
}

六、总结

  • 问题本质 闭包捕获的是定义时的值,不是调用时的值
  • 触发条件 回调函数未随状态更新而重新创建
  • 解决思路 让回调函数能获取到最新值
相关推荐
云起SAAS14 小时前
手机靓号选号商城H5源码 完整前后台可直接运行
前端·javascript·后端
code2cat14 小时前
JavaScript编程篇之异步请求:切换到待办,为什么又显示了全部任务
前端·javascript
1-1=015 小时前
Vue 条件渲染和列表渲染
前端·javascript·vue.js
用户2986985301415 小时前
React 前端实现 Word 与 OpenXML 双向转换的完整实践
javascript·react.js
Highcharts.js15 小时前
Workbuddy + Highcharts Orbit:工作区数据自动建模与可视化分析实践
前端·javascript·信息可视化·数据可视化·highcharts·可视化图表·workbuddy
程序员大阳1 天前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
北城笑笑1 天前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
Patrick_Wilson1 天前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
AI前端工程狮1 天前
我把 MCP 长任务拆成三个工具,token 账单涨了 7 倍
javascript·人工智能·程序员
mONESY1 天前
DeepAgents 从零上手:别再手搓 Harness,用中间件拼出一个调研团队
javascript