React Native开发的iOS应用突然无法接收OneSignal通知求助

以下为优先级从高到低的排查方向：

1. APNs与证书配置校验 #

OneSignal后台显示已送达代表推送请求已成功转发至苹果APNs服务，问题集中在APNs到终端的链路，优先校验证书配置：

• 确认苹果开发者账号下的推送证书未过期，若近期更新过证书，需同步更新OneSignal后台上传的APNs证书，注意严格区分开发环境和生产环境证书，不要混用
• 检查App Store Connect内对应App的推送功能权限是否正常，近期若有账号权限变更、版本提审操作可能会触发权限重置
• 确认打包使用的Bundle ID与OneSignal后台配置的Bundle ID完全一致，无大小写、后缀差异

2. 应用端配置校验 #

• 先在iOS系统设置的对应App通知页，确认通知权限全开，排除用户手动关闭、App更新后权限重置的情况
• 检查Xcode项目Signing & Capabilities配置：需同时添加Push Notifications能力，以及Background Modes能力并勾选Remote notifications选项
• 确认OneSignal初始化代码无变更，初始化时机需放在App启动逻辑最前端，不要滞后于业务逻辑加载，参考初始化代码：

// 放在App入口文件最靠前的执行逻辑中
OneSignal.setAppId("YOUR_ONESIGNAL_APP_ID");
OneSignal.promptForPushNotificationsWithUserResponse(accepted => {
  console.log("通知权限授权结果：", accepted);
});

• 若近期升级过React Native版本，执行cd ios && pod update OneSignal更新原生依赖后重新打包测试，避免react-native-onesignal@4.0.6与当前RN版本原生适配异常

3. 推送Payload规则校验 #

APNs收到推送后未触发系统展示，大概率是Payload配置不符合iOS规则：

• 排查推送Payload的content-available字段是否设为1，该字段标记的静默推送默认不会触发弹窗、提示音等前台展示
• 检查推送优先级设置，低优先级推送会被iOS系统在低电量、后台刷新关闭等场景下拦截
• 若接入了通知扩展（Notification Service Extension）实现富媒体推送，校验扩展的Bundle ID是否为主App Bundle ID的后缀、扩展证书是否未过期、扩展代码无运行异常，扩展报错会导致通知无法正常展示

4. 定向验证手段 #

• 使用OneSignal后台测试推送功能，输入单个iOS设备的Player ID定向发送测试通知，排除全量推送的配置问题
• 开启OneSignal日志调试，连接Xcode运行Debug包查看推送接收时的报错日志，开启日志代码：OneSignal.setLogLevel(6, 0)
• 若Debug包可正常接收、生产包无法接收，直接重新生成生产环境p12证书上传至OneSignal后台即可解决90%以上的同类问题

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