iOS生产环境APNs推送仅后台可接收 前台接收异常排查

按优先级从高到低逐一验证：

• 校验推送payload格式合规性
  生产环境APNs对payload字段校验规则和沙箱环境存在差异，不要以沙箱环境的推送表现作为payload合规的判断标准。如果payload仅配置了content-available:1用于后台唤醒，缺省alert/sound/badge字段，同时前端未实现userNotificationCenter(_:willPresent:withCompletionHandler)回调的前台展示逻辑，就会出现后台可正常唤醒、前台完全收不到推送回调的问题。
• 确认APNs环境与构建包类型匹配
  不要完全依赖Xcode自动切换entitlements配置，手动校验构建产物的.entitlements文件中aps-environment字段值：App Store/TestFlight包必须为production，AdHoc/开发包必须对应匹配的环境值。注意Naver Cloud Platform SENS服务默认不会自动识别包类型对应的APNs网关，如果AdHoc包携带生产环境标记，平台将请求发往生产APNs网关时会出现链路不通，部分场景下会表现为仅后台可收到推送。另外避免重复调用registerForRemoteNotifications，iOS 14+版本在生产环境下重复调用该方法，会偶发导致前台推送权限状态异常。
• 核对推送平台侧的证书与topic配置
  你描述的「重传证书后短暂恢复、一段时间后故障复现」是典型的证书配置异常表现：
  • 导出APNs证书p12文件时必须同时选中证书对应的私钥导出，仅导出公钥的证书上传后，平台侧缓存的旧私钥失效后就会出现推送丢包
  • 通用型（Sandbox&Production）APNs证书绑定唯一的Bundle ID，若同SENS账号下存在多个Bundle ID相近的应用，平台可能出现topic匹配错误，iOS系统后台状态下对topic的校验宽松度高于前台，会直接表现为后台可收、前台不可收
• 校验前端推送回调逻辑
  react-native-push-notification@7.3.1存在已知生产环境bug：如果onNotification回调中未主动调用notification.finish()方法，首次前台收到推送后进程会被系统标记为异常，后续所有前台推送都会被系统拦截。同时需要确认原生层AppDelegate.m的前台推送回调中，明确设置了前台展示选项：

  - (void)userNotificationCenter:(UNUserNotificationCenter *)center willPresentNotification:(UNNotification *)notification withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
    completionHandler(UNNotificationPresentationOptionAlert | UNNotificationPresentationOptionSound | UNNotificationPresentationOptionBadge);
  }
  

• 排除系统级权限异常
  应用重装、iOS系统升级后，部分设备会出现前台通知权限被系统静默重置的情况，需要在应用每次冷启动时调用PushNotificationIOS.checkPermissions()校验权限状态，发现权限异常时重新触发权限申请流程。同时需要排除单设备设置影响：专注模式开启、应用通知设置为静默、设备网络限制APNs连接等情况，都会导致前台推送无法正常触达。
• 链路日志校验
  在原生层埋点记录didReceiveRemoteNotification回调触发情况，确认是APNs未将推送下发到设备，还是应用收到推送后未正常处理：如果是APNs未下发，重点排查证书、环境、payload配置；如果是应用收到后未展示，直接排查前端回调逻辑。

注意：不要默认服务端/云平台配置未发生变更，需要拉取故障发生时间段的推送请求原始日志，核对每一次推送的网关环境、payload结构、证书使用记录，排除平台侧自动更新、配置漂移导致的异常。

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