如何在 React Native 中实现本地数据持久化?

Question

Accepted Answer

React Native 应用通常需要**在本地存储数据**——用户偏好设置、缓存数据、认证令牌、离线内容。选项包括 **AsyncStorage**（键值对）、**MMKV**（高速）、**SQLite** 和**安全存储**（敏感数据）。选择正确的存储方式很重要。

## 本地存储选项

```text
ASYNCSTORAGE → simple async KEY-VALUE storage (the common basic option):
  → store strings (serialize objects to JSON); for settings, small data, simple caching
  → async API; persists across app launches
MMKV → a very FAST key-value storage (by WeChat) — faster than AsyncStorage, synchronous;
  popular modern choice for performance
SQLITE (e.g. expo-sqlite, react-native-sqlite, WatermelonDB) → relational DATABASE for
  STRUCTURED/large data, queries, relationships, offline-first apps
SECURE STORAGE → expo-secure-store / react-native-keychain for SENSITIVE data (tokens,
  credentials) — ENCRYPTED (keychain/keystore)
```

## AsyncStorage 示例

```jsx
import AsyncStorage from '@react-native-async-storage/async-storage';

await AsyncStorage.setItem('user', JSON.stringify(user));   // store (serialize)
const json = await AsyncStorage.getItem('user');
const user = json ? JSON.parse(json) : null;                 // retrieve (parse)
```

## 选择合适的选项

```text
Simple settings/small data → AsyncStorage (or MMKV for speed)
Structured/large/relational/offline data → SQLite / WatermelonDB
SENSITIVE data (auth tokens, passwords) → SECURE storage (encrypted) — NOT AsyncStorage
  (which is NOT secure/encrypted — a common security mistake)
→ Match storage to the data's size, structure, and sensitivity.
```

## 为什么这很重要

理解如何在 React Native 中实现本地数据持久化很有价值，因为**应用通常需要在设备上存储数据**（偏好设置、缓存数据、令牌、离线内容），这对构建真实应用来说是实用的知识。

本地持久化是一个几乎普遍的需求，React Native 提供了多种选项。

理解**各种选项**——**AsyncStorage**（用于设置和小数据的常见简单异步键值存储）、**MMKV**（非常快速的现代键值替代方案）、**SQLite/WatermelonDB**（用于结构化、大型或离线优先数据以及查询的关系数据库），以及**安全存储**（expo-secure-store/react-native-keychain 用于敏感数据）——以及**何时使用每种方案**是关键知识。

选择**正确的选项**很重要：简单数据用 AsyncStorage 或 MMKV、结构化/大型/离线数据用 SQLite，以及至关重要的是**敏感数据用安全存储**，如认证令牌和凭证（必须通过平台 keychain/keystore 加密——一个重要的安全要点，因为 **AsyncStorage 不安全/未加密，不应该存储机密数据**，这是常见的错误）。

使存储与数据的大小、结构和敏感性相匹配反映了良好的决策，避免了问题（选错工具，或不安全地存储凭证）。

了解离线优先解决方案（WatermelonDB）对需要强大离线支持的应用很有价值。

由于应用通常需要本地持久化（设置、缓存、令牌、离线数据），React Native 提供了针对不同需求的选项，并且恰当地选择（特别是为敏感数据使用安全存储）对正确安全地构建真实应用很重要，因此理解 React Native 中的本地数据持久化是宝贵的、实用的知识——这是真实应用中的常见需求，对功能性（以正确的方式存储正确的数据）和安全性（使用安全存储而非 AsyncStorage 保护敏感数据）都很重要，并且对构建能够记住状态和支持离线工作的应用很有用。