未Eject的Expo应用集成OneSignal遇RNOneSignal模块加载错误求助

核心排查步骤 #

• 严格匹配Expo SDK与插件版本
  onesignal-expo-plugin和react-native-onesignal的版本必须和当前Expo SDK版本完全对应，比如：

  • Expo SDK 49：onesignal-expo-plugin@1.5.0，react-native-onesignal@5.0.4
  • Expo SDK 50：onesignal-expo-plugin@2.0.0，react-native-onesignal@5.1.0
    禁止跨版本混用，小版本差异也可能导致原生模块不兼容。

• 检查app.json/app.config.js配置完整性
  确保plugins数组里正确配置OneSignal插件，包含必要参数：

  {
    "expo": {
      "plugins": [
        [
          "onesignal-expo-plugin",
          {
            "mode": "development",
            "devTeam": "YOUR_DEV_TEAM_ID", // iOS必填
            "bundleIdentifier": "com.your.app.id" // 需与应用ID一致
          }
        ]
      ]
    }
  }
  

  iOS开发模式下必须填写devTeam，否则原生模块无法正常编译。

• 清理缓存并重新构建
  执行以下命令彻底清理缓存，避免旧构建文件干扰：

  expo r -c
  expo prebuild --clean
  

  之后重新运行expo start或expo run:ios/android，禁用缓存启动。

• 验证原生配置是否自动生成

  • iOS：检查ios/[AppName]/Info.plist是否包含OneSignal相关配置，比如NSNotificationUsageDescription、OneSignalAppID
  • Android：检查android/app/src/main/AndroidManifest.xml是否有OneSignal的meta-data和权限配置
    若配置缺失，重新执行expo prebuild触发插件的原生配置生成逻辑。

• 避免使用Expo Go测试
  Expo Go不支持自定义原生插件，必须使用**开发构建（Development Build）**测试。执行expo run:ios或expo run:android生成开发构建包，在真机或模拟器上运行，不要用Expo Go扫码测试。

• 确认初始化代码位置正确
  在App.tsx/App.js的最顶部（组件渲染前）初始化OneSignal：

  import OneSignal from 'react-native-onesignal';
  
  OneSignal.initialize('YOUR_ONESIGNAL_APP_ID');
  OneSignal.Notifications.requestPermission(true);
  

  不要在useEffect或其他生命周期里延迟初始化，防止模块未加载完成就调用API。

内容的提问来源于stack exchange，提问作者Mohammad Ali Vakilidoost