React Native中AsyncStorage在Release构建模式下崩溃求助

以下是针对Debug正常、Release构建后崩溃的常见排查和解决步骤：

1. 检查代码混淆规则 #

Release模式默认启用ProGuard/R8混淆，AsyncStorage的原生类可能被误混淆，导致运行时找不到类或方法。

• 打开android/app/proguard-rules.pro，添加以下规则：

  -keep class com.reactnativecommunity.asyncstorage.** { *; }
  -keep class com.facebook.react.modules.storage.** { *; }
  

• 重新执行Release构建命令。

2. 确保JS Bundle正确生成 #

你使用了-x bundleReleaseJsAndAssets跳过JS打包步骤，可能存在缓存的旧JS文件，或者未提前生成正确的Release版bundle：

• 先手动生成Release版JS bundle：

  npx react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/
  

• 确认android/app/src/main/assets/下存在index.android.bundle文件，再执行gradlew assembleRelease -x bundleReleaseJsAndAssets。
• 若不确定，可先去掉-x bundleReleaseJsAndAssets参数，执行完整的gradlew assembleRelease构建，验证是否正常运行。

3. 检查原生模块注册 #

确保AsyncStorage的原生包在Release模式下被正确注册：

• 打开android/app/src/main/java/[你的包名]/MainApplication.java，检查getPackages()方法中是否包含new AsyncStoragePackage()：

  @Override
  protected List<ReactPackage> getPackages() {
    @SuppressWarnings("UnnecessaryLocalVariable")
    List<ReactPackage> packages = new PackageList(this).getPackages();
    // 确认AsyncStoragePackage已添加
    packages.add(new AsyncStoragePackage());
    return packages;
  }
  

4. 排查权限问题 #

部分设备在Release模式下可能存在存储权限限制（尽管AsyncStorage默认使用内部存储，但部分定制系统可能有特殊限制）：

• 打开android/app/src/main/AndroidManifest.xml，添加必要权限（根据目标SDK版本调整）：

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  

• 若目标SDK为33+，需动态申请READ_MEDIA_IMAGES等权限（如果你的应用涉及媒体文件）。

5. 获取崩溃日志定位根因 #

以上步骤无法解决时，通过adb获取详细崩溃日志：

• 连接设备后执行：

  adb logcat *:E
  

• 启动崩溃的应用，查看日志中的FATAL EXCEPTION信息，根据具体报错（如类找不到、方法不存在等）进一步定位问题。

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