Redux-persist未持久化状态，刷新回退初始值且rehydrated状态异常

• 检查是否存在业务逻辑手动触发redux-persist内部action的情况
  redux-persist的rehydrated状态由其内置的action流维护，内部流转的action类型包括persist/PERSIST、persist/REHYDRATE、persist/PAUSE、persist/PURGE等。如果业务代码中手动分发了persist/PAUSE或persist/PURGE类action，会直接中断持久化流程，导致rehydrated从true切换为false，停止向存储写入状态。
  验证方式：通过redux-logger的日志筛选persist/开头的action，确认业务action触发的时序后，是否存在上述中断类action的分发记录，定位对应触发代码并删除即可。
• 核对persistConfig配置与合并reducer的键名匹配度
  当前配置白名单为["cart"]，需确认combineReducers挂载cart reducer时的键名，与白名单中的字符串完全一致，无大小写、拼写差异。若键名不匹配，redux-persist在完成初次rehydrate后，会因找不到对应持久化的状态切片，在后续action触发时判定配置异常，中断持久化流程。
  例如：若合并reducer时写为{ cartData: cartReducer }，但白名单配置为["cart"]，即会出现匹配失败问题，需将两者的键名调整为完全一致。
• 排查中间件对redux-persist内部action的拦截问题
  当前项目引入了redux-logger作为中间件，若同时使用redux-thunk、redux-saga或自定义业务中间件，且中间件内部设置了action放行规则，仅允许业务action通过，拦截了persist/开头的内部action，会导致redux-persist的状态机无法正常流转，出现rehydrated状态异常。
  验证方式：临时移除除redux-persist核心逻辑外的所有中间件，仅保留createStore、persistReducer、persistStore的基础逻辑，测试触发业务action时rehydrated状态是否保持稳定；若状态恢复正常，再逐个加回中间件，定位拦截内部action的模块。
• 检查业务reducer是否覆盖了redux-persist挂载的内置_persist字段
  redux-persist会在根state下自动挂载_persist内置字段，用于存储rehydrated状态、持久化配置等运行时信息。若某个业务reducer在处理action时，未按规范通过展开运算符返回合并后的state，而是直接返回了全新的根state对象，会直接覆盖_persist字段，导致持久化内置状态丢失，表现为rehydrated从true变为false。
  验证方式：在每次业务action触发后，打印根state下的_persist字段，定位是哪次action触发后，_persist字段被删除或rehydrated值被篡改，修正对应reducer的返回逻辑即可。
• 验证存储写入是否触发浏览器存储限额异常
  若持久化的业务状态体积过大，超过localStorage单域名5M的存储限额，写入操作会直接失败。这种场景下初次rehydrate可正常执行（基于历史已写入的存储内容），但触发若干action后，写入新持久化状态时会因超限触发报错，redux-persist会自动进入错误状态，将rehydrated置为false并停止后续持久化。
  验证方式：打开浏览器控制台的Application面板，查看localStorage中persist:root字段的写入状态，同时查看控制台是否存在QuotaExceededError报错；若存在此类问题，需裁剪持久化状态的体积，仅保留必要的持久化字段，或替换默认的localStorage存储适配器为支持更大容量的IndexedDB适配器。

• 修正reducer返回逻辑：所有业务reducer在更新状态时，通过展开运算符保留上一次的state结构，禁止直接返回全新的根state对象覆盖内置字段
• 移除冗余的内部action分发逻辑：全局搜索代码中手动dispatchpersist/开头action的逻辑，全部删除
• 调整中间件执行顺序：将不拦截内部action的中间件放在执行栈最上层，确保redux-persist的内部action可正常流转
• 优化持久化白名单范围：仅将必须持久化的字段加入白名单，避免将大体积非必要数据（如全量接口返回的列表数据、base64格式的大尺寸图片）存入持久化存储

内容的提问来源于stack exchange，提问作者Sameer Katija