React Native：检测应用商店更新并清除Async Storage以修复更新异常

核心思路 #

• 应用启动时获取当前版本号
• 对比本地存储的旧版本号：若当前版本更高，判定为应用商店更新后的首次启动
• 触发Async Storage全量清除，随后将新版本号存入本地，避免重复执行清除操作

React Native环境下的具体实现 #

1. 依赖准备 #

使用react-native-version-check快速获取应用版本号：

npm install react-native-version-check --save
# 或 yarn add react-native-version-check

2. 核心代码（应用入口文件如App.js） #

import AsyncStorage from '@react-native-async-storage/async-storage';
import VersionCheck from 'react-native-version-check';
import { useEffect } from 'react';

const checkAndClearStorageOnUpdate = async () => {
  try {
    const currentVersion = VersionCheck.getCurrentVersion();
    const storedVersion = await AsyncStorage.getItem('app_version');

    // 版本号不一致则执行清除
    if (currentVersion !== storedVersion) {
      await AsyncStorage.clear();
      await AsyncStorage.setItem('app_version', currentVersion);
      console.log('应用已更新，Async Storage已清除');
    }
  } catch (error) {
    console.error('版本检测/存储清除失败:', error);
    // 异常兜底：强制存入当前版本，避免无限触发清除逻辑
    const currentVersion = VersionCheck.getCurrentVersion();
    await AsyncStorage.setItem('app_version', currentVersion);
  }
};

// 应用启动时执行检测
useEffect(() => {
  checkAndClearStorageOnUpdate();
}, []);

3. 关键注意事项 #

• 版本格式统一：确保应用商店提交的版本号（iOS的CFBundleShortVersionString、Android的versionName）与代码中获取的格式完全一致，避免因Build号等额外信息导致对比错误
• 用户体验优化：若清除存储后需要用户重新登录或配置，可在清除操作后弹出提示引导用户
• 原生适配备选：若不依赖第三方库，iOS可直接读取Info.plist中的版本字段，Android读取BuildConfig.VERSION_NAME，逻辑与上述一致

纯原生实现参考 #

• iOS：在AppDelegate或SceneDelegate的启动方法中，读取CFBundleShortVersionString，对比UserDefaults存储的旧版本，不一致则清空UserDefaults并更新存储版本
• Android：在Application类的onCreate方法中，读取BuildConfig.VERSION_NAME，对比SharedPreferences中的旧版本，不一致则清空SharedPreferences并更新存储版本

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