React Native中Session Storage与localStorage的实现方案咨询

1. Expo SecureStore 与 localStorage 的关系 #

Expo SecureStore 确实和 localStorage 特性接近——两者都是持久化键值对存储，数据会跨应用会话保留（除非主动删除）。但 SecureStore 额外提供了加密存储能力，适合保存敏感数据（如token、用户凭证），这是普通 localStorage 不具备的。

2. 实现 Session Storage（会话级存储） #

Session Storage 的核心是「应用活跃会话期间保留，退出/切后台即清除」，可以通过两种方案实现：

方案一：内存存储 + 应用状态监听 #

用内存对象临时存数据，结合 React Native 的 AppState 监听应用状态，在应用切后台或退出时清空内存：

import { AppState, useEffect } from 'react-native';

// 内存存储容器
let sessionStore = {};

// 封装Session Storage API
const setSessionItem = (key, value) => {
  sessionStore[key] = JSON.stringify(value);
};

const getSessionItem = (key) => {
  const rawValue = sessionStore[key];
  return rawValue ? JSON.parse(rawValue) : null;
};

const removeSessionItem = (key) => {
  delete sessionStore[key];
};

const clearSessionStore = () => {
  sessionStore = {};
};

// 监听应用状态，后台/非活跃时清空
useEffect(() => {
  const handleAppStateChange = (nextState) => {
    if (nextState === 'background' || nextState === 'inactive') {
      clearSessionStore();
    }
  };

  AppState.addEventListener('change', handleAppStateChange);
  return () => {
    AppState.removeEventListener('change', handleAppStateChange);
  };
}, []);

方案二：持久化存储 + 会话标记 #

如果需要临时持久化（比如应用重启但未退出会话时保留），可以结合 SecureStore，存数据时附加当前会话的唯一标记（如应用启动时间戳），取数据时校验标记是否匹配：

import * as SecureStore from 'expo-secure-store';

// 生成会话标记（应用启动时执行一次）
const sessionId = Date.now().toString();

const setSessionItem = async (key, value) => {
  const data = { value, sessionId };
  await SecureStore.setItemAsync(key, JSON.stringify(data));
};

const getSessionItem = async (key) => {
  const rawData = await SecureStore.getItemAsync(key);
  if (!rawData) return null;
  
  const { value, sessionId: storedSessionId } = JSON.parse(rawData);
  return storedSessionId === sessionId ? JSON.parse(value) : null;
};

3. 替代 AsyncStorage 的可用库与方案 #

AsyncStorage 移至社区维护后，推荐以下方案：

Expo 生态工具 #

• Expo SecureStore：加密持久化存储，API 简洁（setItemAsync/getItemAsync/deleteItemAsync），适合敏感数据。
• Expo FileSystem：可将数据写入本地文件，适合存储大量非敏感数据，可自行封装为键值对存储 API。

社区主流库 #

• react-native-mmkv：微软维护的高性能存储库，支持内存存储（可配置为 Session 级）和持久化存储，读写速度远优于 AsyncStorage，API 直观。
• @react-native-async-storage/async-storage：官方移至社区的 AsyncStorage 替代包，完全兼容旧版 API，适合现有项目迁移。

参考文档 #

• Expo 官方文档中关于 SecureStore、FileSystem 的章节
• react-native-mmkv 仓库 README
• @react-native-async-storage/async-storage 仓库 README

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