React Native MMKV加密存储数据杀应用后丢失，如何持久化至登出？

核心原因分析 #

加密MMKV在进程重启后"丢失"数据，绝大多数情况不是数据真的被清空了，而是重启后无法正确获取加密密钥，导致无法读取原有存储的数据，看起来像是数据消失。其次可能是实例初始化配置不一致，导致每次启动都创建新的存储实例。

解决方案 #

1. 安全持久化加密密钥 #

不要把密钥存在内存中，要把密钥存储到系统安全容器：iOS用Keychain，Android用Keystore。每次启动应用时从容器中读取密钥，再初始化MMKV实例。

代码示例：

首先封装密钥管理工具：

import { Platform } from 'react-native';
import Keychain from 'react-native-keychain';

// 存储加密密钥到系统安全容器
export const saveMMKVEncryptionKey = async (key) => {
  await Keychain.setGenericPassword('mmkv_encryption_key', key, {
    accessible: Keychain.ACCESSIBLE.WHEN_UNLOCKED,
  });
};

// 从系统安全容器读取密钥
export const getMMKVEncryptionKey = async () => {
  const credentials = await Keychain.getGenericPassword();
  return credentials ? credentials.password : null;
};

// 生成随机加密密钥（仅首次初始化时调用）
export const generateMMKVKey = () => {
  return Array.from(crypto.getRandomValues(new Uint8Array(32)))
    .map(b => b.toString(16).padStart(2, '0'))
    .join('');
};

然后初始化MMKV实例：

import { MMKV } from 'react-native-mmkv';

let mmkvInstance = null;

export const getMMKVInstance = async () => {
  if (mmkvInstance) return mmkvInstance;

  let encryptionKey = await getMMKVEncryptionKey();
  // 首次启动时生成并存储密钥
  if (!encryptionKey) {
    encryptionKey = generateMMKVKey();
    await saveMMKVEncryptionKey(encryptionKey);
  }

  mmkvInstance = new MMKV({
    id: 'user_storage', // 固定实例ID，确保每次启动都用同一个存储
    encryptionKey: encryptionKey,
  });

  return mmkvInstance;
};

2. 确保实例初始化的一致性 #

• 必须使用固定的id参数创建MMKV实例，不能每次启动生成随机ID，否则会创建新的存储文件，无法读取旧数据。
• 加密密钥必须和存储数据时使用的密钥完全一致，否则会解密失败，返回空值。

3. 避免错误的存储模式 #

MMKV默认是持久化存储，但如果手动设置了memoryOnly: true，数据只会存在内存中，进程重启后就会丢失。检查初始化代码，确保没有开启内存模式：

// 错误示例：内存模式，进程重启丢失数据
new MMKV({ memoryOnly: true });

// 正确示例：持久化存储
new MMKV({ id: 'user_storage', encryptionKey: key });

4. 错误处理与调试 #

如果还是出现问题，可以添加调试日志，检查密钥是否正确读取，以及MMKV实例的状态：

const mmkv = await getMMKVInstance();
console.log('MMKV实例ID:', mmkv.id);
console.log('是否能读取用户数据:', mmkv.getString('userInfo') ? '是' : '否');
console.log('当前加密密钥:', await getMMKVEncryptionKey());

用户登出时的处理 #

登出时需要清空MMKV存储并删除加密密钥（可选，根据需求）：

export const logout = async () => {
  const mmkv = await getMMKVInstance();
  mmkv.clearAll(); // 清空存储数据
  await Keychain.resetGenericPassword(); // 删除加密密钥
};

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