React Native应用升级react-native-onesignal后安装成功却无法启动

针对你升级Android SDK到31、更新react-native-onesignal到4.2.0后应用闪屏崩溃的问题，按以下步骤逐一排查：

1. 先抓取崩溃日志（最关键） #

闪屏崩溃必然对应原生层面的报错，先通过adb logcat获取具体错误信息：

# 过滤当前应用的错误日志，替换成你的包名
adb logcat -s com.appopaprofessional:E

或打开Android Studio的Logcat面板，选择你的应用进程，过滤Error级别日志，找到崩溃的堆栈信息——这是定位核心问题的最快方式。

2. 检查OneSignal初始化代码兼容性 #

react-native-onesignal 4.x版本的初始化逻辑和4.0.x有明显差异：

• 旧版本常用同步写法：OneSignal.init('YOUR_APP_ID')
• 4.2.0要求异步初始化，且API有调整，示例代码：

import OneSignal from 'react-native-onesignal';

// 在App启动时（比如index.js或根组件的useEffect中）
async function initOneSignal() {
  await OneSignal.initialize('YOUR_APP_ID');
  // 通知监听等其他配置也需要适配新版本API
}
initOneSignal();

如果仍沿用旧的同步写法，会直接导致初始化失败崩溃。

3. 补全AndroidManifest中OneSignal组件的android:exported属性 #

SDK31强制要求所有带有intent-filter的组件必须显式设置android:exported。react-native-onesignal 4.x会自动注册广播接收器、服务等组件，但默认配置可能未添加该属性，需手动补充：

<!-- OneSignal 广播接收器 -->
<receiver
    android:name="com.onesignal.GcmBroadcastReceiver"
    android:exported="true" />
<receiver
    android:name="com.onesignal.NotificationOpenedReceiver"
    android:exported="true" />

<!-- OneSignal 服务 -->
<service
    android:name="com.onesignal.SyncService"
    android:exported="false" />
<service
    android:name="com.onesignal.RegistrationIntentService"
    android:exported="false" />

注意根据组件是否需要接收外部Intent，设置exported为true或false。

4. 检查依赖版本兼容性 #

• React Native版本匹配：react-native-onesignal 4.2.0最低要求RN0.67.x，而你当前使用的RN0.66.4不在兼容范围内，版本不兼容会直接引发运行时崩溃。解决方案二选一：要么升级RN到0.67+，要么降级react-native-onesignal到兼容0.66的版本（比如4.1.x）。
• Firebase依赖冲突：你使用的@react-native-firebase/app是14.2.2，react-native-onesignal 4.x依赖的Google Play Services版本可能和Firebase的依赖版本冲突。可在android/build.gradle中统一配置版本：

buildscript {
    ext {
        // 新增统一版本配置
        googlePlayServicesVersion = "21.0.1"
        // ...其他原有配置
    }
}

5. 清理构建缓存 #

残留的旧缓存可能导致依赖加载异常，执行以下步骤彻底清理：

# 删除依赖文件与锁文件
rm -rf node_modules package-lock.json yarn.lock
# 重新安装依赖
npm install # 或 yarn install
# 清理Android构建缓存
cd android && ./gradlew clean
# 重新构建应用
cd .. && react-native run-android

6. 适配SDK31新增权限 #

SDK31新增了POST_NOTIFICATIONS权限，react-native-onesignal 4.x需要动态申请该权限才能正常工作，若未申请可能导致初始化崩溃。在应用启动时添加权限申请代码：

import { PermissionsAndroid, Platform } from 'react-native';

async function requestNotificationPermission() {
  if (Platform.OS === 'android' && Platform.Version >= 33) {
    const granted = await PermissionsAndroid.request(
      PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS,
      {
        title: '通知权限请求',
        message: '应用需要通知权限接收推送',
        buttonNeutral: '稍后再说',
        buttonNegative: '取消',
        buttonPositive: '允许',
      },
    );
    if (granted !== PermissionsAndroid.RESULTS.GRANTED) {
      console.log('通知权限被拒绝');
    }
  }
}
// 在初始化OneSignal前调用
requestNotificationPermission();

内容的提问来源于stack exchange，提问作者Rafael Nery Machado