Ionic Capacitor项目OneSignal初始化报错 无法查看用户发送推送

问题根因 #

报错明确指向OneSignal初始化流程缺失必要参数，设备未完成和OneSignal后台的注册流程，因此后台无法识别到测试设备，自然无法展示用户列表、也无法下发通知，iOS和安卓端出现同一问题均由此导致。

修复步骤 #

• 第一步：先确认依赖兼容性，你使用的是Capacitor 3.x版本，需搭配onesignal-cordova-plugin@3.0.0及以上版本，若使用@ionic-native/onesignal封装包，需同步升级到v5及以上版本。
• 第二步：修正初始化代码，在根组件（通常为app.component.ts）的构造函数中，确保平台就绪后再执行初始化，同时补全缺失的启动参数配置，示例代码如下：

import { OneSignal } from '@ionic-native/onesignal/ngx';
import { Platform } from '@ionic/angular';

constructor(private platform: Platform, private oneSignal: OneSignal) {
  this.platform.ready().then(async () => {
    // 替换为你自己的OneSignal App ID
    this.oneSignal.startInit('你的OneSignal应用ID');
    
    // 补全iOS端要求的launchOptions参数，对应报错提示的缺失配置
    if (this.platform.is('ios')) {
      this.oneSignal.iOSSettings.setLaunchOptions(launchOptions);
      // 配置iOS端自动请求推送权限
      this.oneSignal.iOSSettings.setAutoPrompt(true);
    }

    // 可选：配置通知接收、点击的自定义回调
    this.oneSignal.handleNotificationReceived().subscribe(notification => {
      // 处理应用在前台时收到通知的逻辑
    });
    this.oneSignal.handleNotificationOpened().subscribe(openResult => {
      // 处理用户点击通知后的跳转逻辑
    });

    // 完成初始化
    this.oneSignal.endInit();
  })
}

如果你没有使用@ionic-native的封装，直接调用原生JS API的写法如下：

document.addEventListener('deviceready', () => {
  window.plugins.OneSignal.setAppId("你的OneSignal应用ID");
  // iOS端必须传入启动参数
  if (window.cordova.platformId === 'ios') {
    window.plugins.OneSignal.setLaunchOptions(launchOptions);
  }
}, false);

• 第三步：检查安卓端额外配置
  • 确认你已将Firebase生成的google-services.json文件放到安卓项目的android/app/目录下
  • 确认OneSignal后台已正确配置安卓端对应的Firebase服务器密钥
• 第四步：同步配置并重新测试
  • 执行npx cap sync同步所有原生配置到iOS和安卓项目
  • 删除设备上已安装的旧版测试应用，重新编译安装
  • 启动应用后同意推送权限申请，等待1-2分钟后刷新OneSignal后台用户列表，即可看到成功注册的测试设备，可正常下发测试通知。

额外排查点 #

如果按上述步骤操作后仍未解决，可检查：

• OneSignal后台上传的iOS推送证书是否有效、是否匹配当前应用的Bundle ID
• 项目的Native层配置中，推送相关权限是否已正常开启

内容的提问来源于stack exchange，提问作者José Pineda