React Native应用仅Android 13生产环境崩溃，求排查修复方案

核心排查方向与修复方案 #

1. 权限适配问题（Android 13新增权限要求） #

Android 13对通知、媒体权限做了拆分，未适配新增权限会触发崩溃：

• 修复：
  • 在AndroidManifest.xml中添加通知权限声明：

    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
    

  • 若应用需要推送，动态申请通知权限：

    import { PermissionsAndroid, Platform } from 'react-native';
    
    const requestNotificationPermission = async () => {
      if (Platform.OS === 'android' && Platform.Version >= 33) {
        const granted = await PermissionsAndroid.request(
          PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS,
          {
            title: '通知权限请求',
            message: '应用需要通知权限推送消息',
            buttonPositive: '允许',
            buttonNegative: '取消',
          },
        );
        return granted === PermissionsAndroid.RESULTS.GRANTED;
      }
      return true;
    };
    

2. Target SDK版本未适配Android 13 #

targetSdkVersion低于33会触发Android 13兼容性限制：

• 修复：
  在android/app/build.gradle中修改配置：

  android {
    defaultConfig {
      targetSdkVersion 33 // 升级至33及以上
    }
  }
  

  同步Gradle后，检查第三方依赖是否兼容该版本，不兼容则升级对应库。

3. 第三方库兼容性问题 #

老版本第三方库（如蓝牙、存储、推送类）未适配Android 13会引发崩溃：

• 修复：
  • 检查package.json依赖版本：
    • react-native建议升级至0.71+（完全适配Android 13）
    • 升级react-native-firebase、react-native-image-picker等库到官方标注支持Android 13的版本
  • 无更新的老旧库，可替换为替代库或自行修改适配代码。

4. ProGuard/R8混淆导致崩溃 #

生产环境混淆规则未适配Android 13，会误删必要类或方法：

• 修复：
  • 在android/app/proguard-rules.pro中添加基础混淆规则：

    -keep class com.facebook.react.** { *; }
    -keep class com.facebook.jni.** { *; }
    

  • 为第三方库添加对应混淆规则（参考库官方文档）
  • 若暂时无法排查，可先关闭混淆测试：

    android {
      buildTypes {
        release {
          minifyEnabled false
          shrinkResources false
        }
      }
    }
    

    确认是混淆问题后再逐步调整规则。

5. 存储权限适配问题 #

Android 13拆分了旧存储权限，沿用旧逻辑会崩溃：

• 修复：
  • 读取媒体文件时，改用READ_MEDIA_IMAGES、READ_MEDIA_VIDEO、READ_MEDIA_AUDIO权限，在Manifest中声明并动态申请
  • 优先使用应用内部存储getFilesDir()或getCacheDir()，避免依赖外部存储私有目录。

6. WebView兼容性问题 #

Android 13 WebView内核更新，未适配会导致加载崩溃：

• 修复：
  • 升级react-native-webview至11.26+版本
  • 在AndroidManifest.xml中确保添加网络权限：

    <uses-permission android:name="android.permission.INTERNET" />
    

  • 检查WebView加载页面是否包含Android 13不兼容的JS API。

排查步骤建议 #

• 在Android 13设备上运行debug版本，查看Logcat的FATAL EXCEPTION日志，定位具体崩溃点
• 对比debug与release版本差异，确认是否为混淆、签名或环境配置问题
• 逐步禁用第三方库，排查具体引发崩溃的依赖

内容的提问来源于stack exchange，提问作者Bilge Nur Saglam