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叠加导致的:
- State 初始值类型与更新逻辑不匹配
getStore的初始值被定义为空数组[],但代码中通过setStore更新时传入的是包含addMoreOptions/displayFields属性的对象。首次渲染时由于getStore是数组结构,getStore.addMoreOptions实际为undefined,后续useEffect执行完成后才会将getStore更新为对象类型。这个类型断层会导致React在组件首次挂载时,存入内部缓存的初始props和后续实际传递的props结构存在差异。 - 状态更新违反不可变原则,导致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
相关产品推荐
相关产品推荐

