You need to enable JavaScript to run this app. React.memo自定义比较函数获取的prevProps始终为初始值的异常
优惠活动
大模型
产品
解决方案
定价
更多

React.memo自定义比较函数获取的prevProps始终为初始值的异常

React.memo 自定义比较函数 prevProps 异常问题

问题现象

在使用React.memo对子组件做渲染优化的开发场景中,出现异常表现:自定义props比较函数读取的prevProps始终为组件挂载时的初始值,而非组件上一轮接收到的真实props。具体表现为:

  • 组件首次渲染时defaultValues初始为空数组[],后续状态更新后切换为包含数据的数组[{...}],该阶段渲染表现符合预期
  • 当在父组件中把addMoreOptions状态置为空数组时,比较函数读取到的prevProps理应是上一轮的非空数组,实际打印结果永远为挂载时的初始空数组,无法正确识别props差异,控制台可见日志输出异常

相关代码

父组件 AProfileFilter

const AProfileFilter = ({ data = [] }) => {
    const [getData, setData] = useState([]);
    const [getStore, setStore] = useState([]);
    
    useEffect(() => {
        setData(prepareFilterData(data));
    }, [data]);

    useEffect(() => {
        setStore({ 
          "addMoreOptions": getData.filter((flr) => flr.isShow === false), 
          "displayFields": getData.filter((flr) => flr.isShow === true) 
        })
    }, [getData]);
  
    // 业务逻辑:getStore 中的 addMoreOptions 会根据特定条件动态更新
    return <ASelect defaultValues={getStore.addMoreOptions} />
}
export default AProfileFilter;

子组件 ASelect

const ASelect = (props) => {
    // 组件业务逻辑
}
function areEqual(prevProps, nextProps) {
  console.log("prevProps > ", prevProps.defaultValues, "nextProps > ", nextProps.defaultValues);
  return _.isEqual(prevProps.defaultValues, nextProps.defaultValues);
}
export default memo(ASelect, areEqual);

问题根因

这个异常是两个典型React开发bug叠加导致的:

  1. State 初始值类型与更新逻辑不匹配
    getStore的初始值被定义为空数组[],但代码中通过setStore更新时传入的是包含addMoreOptions/displayFields属性的对象。首次渲染时由于getStore是数组结构,getStore.addMoreOptions实际为undefined,后续useEffect执行完成后才会将getStore更新为对象类型。这个类型断层会导致React在组件首次挂载时,存入内部缓存的初始props和后续实际传递的props结构存在差异。
  2. 状态更新违反不可变原则,导致memo缓存逻辑异常
    按照React.memo的官方运行机制:
  • 自定义比较函数的入参prevProps,是上一次真正触发子组件重渲染时存入的props快照
  • 当比较函数返回true(即判定props相等)时,React会跳过重渲染流程,且不会更新内部缓存的props快照
    动态更新addMoreOptions的业务逻辑中,大概率存在直接修改原state对象属性的写法(比如直接执行getStore.addMoreOptions = [],而非调用setStore生成全新的state对象)。这种写法会导致传递给子组件的defaultValues引用始终和初始缓存值保持一致,自定义比较函数每次都判定_.isEqual(prev.defaultValues, next.defaultValues)为true,子组件跳过重渲染流程,React内部缓存的props快照永远停留在第一次挂载时的初始值。
    感知到的“首次更新后非空数组渲染正常”的现象,实际是第一次从数组类型的初始state切换到对象类型的state时,props引用发生了本质变化,比较函数判定不相等返回false触发了重渲染;但后续所有基于同一个state对象篡改属性的更新,因为没有生成新的对象引用,比较函数始终判定相等,缓存的props快照没有得到更新。

修复方案

  • 修正getStore的初始值定义,保证状态结构从初始化开始就和更新后的结构完全一致,避免类型断层:
    // 修正前:const [getStore, setStore] = useState([]);
    const [getStore, setStore] = useState({
      addMoreOptions: [],
      displayFields: []
    });
    
  • 所有对getStore的状态更新,必须遵循React的不可变更新原则,调用setStore时返回全新的对象引用,禁止直接修改原有state对象的属性:
    // 错误写法:直接修改原state对象
    // getStore.addMoreOptions = []
    
    // 正确写法:生成新的state对象,触发状态更新
    const clearAddMoreOptions = () => {
      setStore(prev => ({
        ...prev,
        addMoreOptions: []
      }))
    }
    
  • 检查组件导出的拼写一致性,确保组件定义名和导出名匹配,避免出现组件实例加载异常的问题。
  • 验证自定义比较函数的逻辑,确保props内容实际发生变化时能够正确返回false触发重渲染,让React及时更新内部缓存的props快照。

内容的提问来源于stack exchange,提问作者Jayesh Naghera

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 07:15:03