iOS13及以上设备PushKit代理didReceiveIncomingPushWithPayload后台/杀死状态不触发
iOS 13+ 后台/被杀状态无法接收VoIP推送排查方案
核心原因
iOS 13对PushKit做了强制约束:收到VoIP类型推送后必须在规定时间内调用CallKit的reportNewIncomingCallWithUUID方法上报来电,未满足要求的App会被系统标记,多次触发违规后系统会直接拦截该App的所有后续VoIP推送,这是iOS 13+版本特有的限制,和你遇到的版本差异现象完全匹配。
具体排查点
服务端APNs推送头配置检查
iOS 13+要求VoIP推送必须在请求APNs时携带指定头字段,缺失会导致后台/被杀状态推送被拦截:- 必须添加
apns-push-type字段,值固定为voip - 必须设置
apns-priority为10(最高优先级) - 建议
apns-expiration设置为大于0的值,避免推送立即过期
- 必须添加
客户端代码问题检查
- 不要同时实现新旧版本的
didReceiveIncomingPushWithPayload代理方法:如果你同时实现了不带completionHandler的旧版代理(iOS11之前的废弃API)和新版带completion的代理,系统会优先调用旧版,导致iOS13+下无法触发正确回调,直接删掉旧版代理实现即可。 - 你的
CXCallUpdate配置缺失必要字段:现有代码仅设置了remoteHandle,建议补充localizedCallerName字段,部分iOS版本如果来电信息不完整会导致CallKit上报失败,触发系统惩罚。 - PKPushRegistry初始化时机检查:确保
PKPushRegistry的初始化逻辑放在didFinishLaunchingWithOptions的最靠前位置,不要被其他业务初始化逻辑阻塞。App被杀状态下收到VoIP推送会被系统唤醒,必须在唤醒后极短时间内完成PKPushRegistry的初始化和delegate赋值,否则会丢失推送事件。 - 确保所有分支都调用了completion回调:现有代码仅在CallKit上报的completion里调用了系统的推送completion,如果
reportNewIncomingCallWithUUID返回错误,也要保证调用completion,否则会被系统判定为未处理推送。
- 不要同时实现新旧版本的
测试环境校验
- 如果之前测试过程中多次出现收到推送未正确上报CallKit的情况,系统会临时拦截你的App的VoIP推送,解决方法是卸载App,重启设备后重新安装测试,清除系统的标记记录。
- 确认测试用的证书类型和推送环境匹配:开发证书对应APNs沙箱环境,生产证书对应APNs生产环境,环境不匹配会导致推送仅前台能收到、后台收不到。
- 不要用Xcode Debug模式长时间挂着测试后台/被杀场景,Xcode调试状态会改变App的生命周期优先级,建议断开Xcode连接后再测试后台/被杀场景的推送接收。
内容的提问来源于stack exchange,提问作者Devjgs
相关产品推荐
相关产品推荐

