React-Native OneSignal Android报错：OneSignal.init未调用

你遇到的核心问题是Android端调用OneSignal API时，库的自动初始化还未完成就触发了方法调用，导致出现OneSignal.init has not been called的报错。结合你的代码和官方v5.0文档，我整理了几个排查和解决方向：

1. 确认Android端基础配置是否完整 #

虽然官方强调自动初始化，但Android端必须确保以下配置到位，否则自动初始化会静默失败：

• 检查android/app/src/main/AndroidManifest.xml中是否添加了OneSignal的APP ID配置：

  <meta-data android:name="com.onesignal.ONESIGNAL_APP_ID" android:value="你的ONESIGNAL_APP_ID"/>
  

• 确认android/build.gradle和android/app/build.gradle中已正确引入OneSignal依赖，且版本与你的React Native版本兼容（v5.0要求React Native 0.60+）。

2. 主动确保初始化完成后再调用API #

官方的自动初始化是异步执行的，根组件中过早调用ensureSubscription会赶在初始化完成前触发API调用。你可以手动触发初始化并等待完成，或者监听初始化事件：

修改你的辅助函数，补充初始化逻辑：

// 新增初始化方法，确保OneSignal完成初始化
initOneSignal = async () => {
  // v5.0中可手动调用initialize确保初始化完成，传入你的APP_ID
  await OneSignal.initialize("你的ONESIGNAL_APP_ID");
  // 可选：监听初始化完成事件，便于调试
  OneSignal.addListener('initialized', () => {
    console.log('OneSignal初始化完成');
  });
}

getPermissionSubscriptionState = async () => {
  // v5.0中该API已改为Promise形式，无需传入回调
  try {
    const state = await OneSignal.getPermissionSubscriptionState();
    console.log(state);
    return state;
  } catch (error) {
    console.error('获取订阅状态失败:', error);
    throw error;
  }
}

ensureSubscription = async () => {
  // 先确保初始化完成，再执行后续逻辑
  await this.initOneSignal();
  const status = await this.getPermissionSubscriptionState();
  console.log(status);
  if(!status.notificationsEnabled && !status.hasPrompted) {
    OneSignal.registerForPushNotifications();
  }
  return status;
}

3. 修正API调用方式以匹配v5.0规范 #

你原代码中使用的回调式getPermissionSubscriptionState是旧版本写法，v5.0已全面切换为Promise-based API，回调写法会导致状态检测逻辑不可靠，改用async/await的Promise调用能避免这类问题。

4. 清理缓存并重新构建项目 #

缓存问题可能导致配置无法生效，尝试以下操作：

• 清理React Native缓存：npx react-native start --reset-cache
• 清理Android构建缓存：cd android && ./gradlew clean
• 重新构建Android项目：npx react-native run-android

按照以上步骤排查后，应该能解决Android端的初始化超时和报错问题。

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