Redux持久化状态迁移：React Native中Auth状态结构升级问题

1. 如何识别当前传入的持久化状态？ #

redux-persist的迁移函数会直接接收存储中读出的旧状态作为参数，你可以通过两种方式识别结构版本：

• 字段特征判断：对比新旧状态的结构差异——旧状态有顶级的token/expiresAt字段，新状态则是accessToken对象；旧状态的numberOfTimeAskedForData是顶级字段，新状态放在dataInfo下。通过检查这些特征字段的存在性，就能判断当前状态属于旧结构还是新结构。
• 版本号控制：在persist配置中指定version字段，每次状态结构变更时升级版本号。migrations对象的key对应目标版本号，函数负责将低版本状态迁移到高版本。比如从版本1升级到版本2，就写'2': (state) => 迁移逻辑。

2. 如何正确映射新旧状态结构？ #

根据你的新旧状态定义，迁移逻辑需要完成字段重组和默认值补全，以下是完整实现代码：

第一步：定义迁移规则 #

import { createMigrate } from 'redux-persist';

const migrations = {
  // 假设之前版本为1，现在升级到版本2
  '2': (oldState) => {
    // 定位到Auth切片（若persist针对根状态）
    const oldAuthState = oldState.auth;
    if (!oldAuthState) return oldState;

    // 构建新的accessToken对象
    const accessToken = oldAuthState.token && oldAuthState.expiresAt 
      ? { token: oldAuthState.token, expiresAt: oldAuthState.expiresAt } 
      : undefined;

    // 构建dataInfo对象，补全必填字段默认值
    const dataInfo = {
      numberOfTimeAskedForData: oldAuthState.numberOfTimeAskedForData ?? 0,
      lastDateAskedForData: oldAuthState.lastDateAskedForData
    };

    // 返回新的Auth状态结构
    return {
      ...oldState,
      auth: {
        accessToken,
        customer: oldAuthState.customer,
        dataInfo,
        dismissedQuizQuestions: oldAuthState.dismissedQuizQuestions ?? []
      }
    };
  }
};

export const migrate = createMigrate(migrations, { debug: false });

第二步：更新Persist配置 #

在persistCombineReducers的配置中指定版本和迁移函数：

import { persistCombineReducers } from 'redux-persist';
import AsyncStorage from '@react-native-async-storage/async-storage';
import { migrate } from './migrations';

const persistConfig = {
  key: 'root',
  storage: AsyncStorage,
  version: 2, // 升级到新的版本号
  migrate,
  // 其他配置项...
};

const rootReducer = persistCombineReducers(persistConfig, {
  auth: authReducer,
  // 其他reducer...
});

关键注意点 #

• 边界处理：旧状态可能存在字段缺失的情况，要用空值合并运算符(??)给必填字段设置默认值，避免新结构出现未定义的必填项。
• 全局状态定位：如果persist针对根状态，迁移函数里要先定位到auth切片；若单独persist auth reducer，直接处理传入的oldState即可。
• 调试开关：将createMigrate的debug设为true，可在控制台查看迁移日志，方便排查问题。

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