React Native iOS端APNs静默推送异常问题求助

问题概述 #

安卓端静默推送功能正常，但iOS端存在三类异常：

• 多设备推送不可靠：测试iOS15和iOS16设备时，其中一台无法接收推送，启动App后也无显示
• 设备关机开机后，未启动App则无法接收推送
• 重启设备后未启动App，发送的APNs推送无法接收

额外信息：

• 推送payload仅设置content-availability: true，APNs返回状态码始终为200
• 使用的React Native推送库：react-native-push-notification（iOS端扩展及核心库）

日志分析 #

第一类问题日志 #

"com.apple.pushLaunch.de.example.app:37D069:[{name: ApplicationPolicy, policyWeight: 50.000,
response: {Decision: Absolutely Must Not Proceed, Score: 0.00, 
Rationale: [{[pushDisallowed]: Required:0.00, Observed:1.00},]}}
{name: BootTimePolicy, policyWeight: 0.010, response: 
{Decision: Must Not Proceed, Score: 0.00, 
Rationale: [{[Minimum seconds after boot]: Required:120.00, Observed:68.56},]}}
{name: , policyWeight: 1.000, response: {Decision: Must Not Proceed, Score: 0.00, 
Rationale: [{timeSinceThunderingHerdTriggerEvent < 300}]}}], 
FinalDecision: Absolutely Must Not Proceed}"

• ApplicationPolicy：系统判定应用当前不允许被推送唤醒（pushDisallowed值为1）
• BootTimePolicy：设备开机未满120秒，系统限制推送唤醒
• 惊群效应限制：开机后5分钟内推送被限流

第三类问题日志 #

"Daemon Canceling Activities: {(com.apple.pushLaunch.de.example.app:E7F648)}"

"CANCELED:com.apple.pushLaunch.de.example.app:E7F648 at priority 5 <private>!"

"com.apple.pushLaunch.de.example.app:71F21A:[{name: ApplicationPolicy, policyWeight: 50.000, response: 
{Decision: Absolutely Must Not Proceed, Score: 0.00, 
Rationale: [{[pushDisallowed]: Required:0.00, Observed:1.00},]}}
{name: ThunderingHerdPolicy, policyWeight: 1.000, response: 
{Decision: Must Not Proceed, Score: 0.00,
Rationale: [{timeSinceThunderingHerdTriggerEvent < 300}]}}], 
FinalDecision: Absolutely Must Not Proceed}"

• 推送唤醒请求被系统守护进程取消
• 核心原因仍是应用被限制推送唤醒，以及短时间内推送触发限流

解决方案建议 #

1. 验证推送权限状态 #

• 检查用户是否已授予应用推送通知权限，且未在系统设置中关闭
• 在iOS原生代码中调用UNUserNotificationCenter.current().getNotificationSettings，确认authorizationStatus为.authorized，且alertSetting不为.notSupported
• 注意：iOS 13+ 中，若用户关闭“允许通知”，即使开启后台刷新，静默推送也会被拦截

2. 优化推送Payload与发送策略 #

• 必须添加apns-push-type: background和apns-priority: 5（后台推送强制要求优先级5，否则会被系统过滤）
• 避免短时间内向同一设备批量发送静默推送，建议推送间隔至少5分钟，规避惊群效应限流
• 设备开机后延迟120秒再发送推送，绕过BootTimePolicy限制

3. 检查React Native库配置 #

• 确认AppDelegate.m中正确实现didReceiveRemoteNotification:fetchCompletionHandler:，处理完推送后必须调用completionHandler(UIBackgroundFetchResultNewData)，否则系统会降低后续推送优先级
• 确保Info.plist中已添加UIBackgroundModes数组，包含remote-notification项，开启后台推送权限
• 更新react-native-push-notification到最新版本，修复已知的iOS静默推送兼容问题

4. 适配系统固有限制 #

• iOS设备重启后未启动App时，系统会严格限制未激活应用的推送唤醒频率，这是系统级机制，无法完全绕过
• 若业务依赖开机即接收推送，可引导用户开启“后台App刷新”（设置>通用>后台App刷新），但用户有权关闭此选项

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