SuperAPI AI 工具集

axiom-push-notifications-diag

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:系统化排查推送通知故障,包括通知未到达、令牌注册错误、环境不匹配、静默推送被限流、Service Extension 问题等。核心原则是先验证授权与令牌注册,再排查载荷与投递逻辑。

主要能力:提供故障概率分布参考(令牌/注册失败约30%、授权与描述文件不匹配约25%、载荷结构错误约15%、Focus/中断抑制约15%、Service Extension 失败约10%、投递时序/限流约5%);列出常见症状与可能原因对照表;给出强制首步诊断流程,包括用 security cms -D -i path/to/embedded.mobileprovision | grep -A1 "aps-environment" 检查推送授权、检查令牌注册回调、用 curl 验证载荷、检查授权状态;提供六棵决策树,覆盖完全收不到通知、开发正常生产失败、静默推送不唤醒、富通知缺媒体、Live Activity 推送不更新、iOS 更新后通知失效;介绍 Apple Push Notification Console 工作流与 simctl 模拟器测试方法;包含 FCM 常见诊断(如 swizzling 冲突)。

使用方式:按强制首步顺序执行诊断,再依据症状进入对应决策树;模拟器测试可用 xcrun simctl push booted com.your.bundle.id test-push.apns,或直接拖拽 .apns 文件到模拟器窗口。

适用场景:iOS 推送通知开发与调试、生产环境推送故障定位、静默推送与富通知配置、Live Activity 推送排查。

限制:模拟器无法注册远程通知,也无法准确测试静默推送唤醒与 Live Activity 推送更新;静默推送受系统限流(约每小时2-3次),被用户强制退出的应用不会被唤醒;Live Activity 频繁更新约每小时10-12次,带声音提醒约每小时3-4次;.critical 中断级别需向 Apple 申请授权。部分内容(如 FCM 诊断代码)在资料中未完整提供。