iOS可交互远程通知不显示问题排查求助

以下是你可能遗漏的配置或步骤，按优先级排查：

1. 确认推送Payload的结构正确性 #

APNS返回200仅代表请求合法，但Payload结构错误会导致设备静默丢弃通知。需确保：

• category字段必须嵌套在aps字典内，而非顶层结构。正确示例：

  {
    "aps": {
      "alert": {
        "title": "会议邀请",
        "body": "请确认参会状态"
      },
      "category": "MEETING_INVITE",
      "sound": "default"
    }
  }
  

• 不要遗漏alert字段（即使仅需按钮交互），iOS需要该字段触发通知展示逻辑。

2. 检查通知类别注册的时机 #

类别必须在APNS推送到达前完成注册，否则设备无法识别category字段，会丢弃通知。正确做法：

• 在AppDelegate的application(_:didFinishLaunchingWithOptions:)方法中，先注册类别，再请求通知权限、注册远程通知。示例代码顺序：

  // 1. 注册通知类别
  let acceptAction = UNNotificationAction(identifier: "ACCEPT", title: "接受", options: [])
  let tentativeAction = UNNotificationAction(identifier: "TENTATIVE", title: "暂定", options: [])
  let declineAction = UNNotificationAction(identifier: "DECLINE", title: "拒绝", options: [])
  let meetingCategory = UNNotificationCategory(identifier: "MEETING_INVITE", actions: [acceptAction, tentativeAction, declineAction], intentIdentifiers: [], options: [])
  UNUserNotificationCenter.current().setNotificationCategories([meetingCategory])
  
  // 2. 请求通知权限
  UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound, .badge]) { granted, error in
      // 处理权限结果
  }
  
  // 3. 注册远程通知
  UIApplication.shared.registerForRemoteNotifications()
  

• 若使用SceneDelegate（iOS13+），需在scene(_:willConnectTo:options:)中重复注册类别，避免app从后台冷启动时类别未加载。

3. 验证推送环境与设备环境匹配 #

Token方式推送时，环境不匹配会导致APNS返回200但设备收不到通知：

• 若设备是调试模式（通过Xcode运行），需使用开发环境APNS服务器：api.development.push.apple.com:443，并使用开发环境的Auth Key。
• 若设备是生产模式（Ad Hoc或App Store版本），需使用生产环境APNS服务器：api.push.apple.com:443，并使用生产环境的Auth Key。

4. 检查UNUserNotificationCenterDelegate的实现 #

若delegate未正确设置或实现，可能导致通知无法展示：

• 必须在didFinishLaunchingWithOptions中提前设置delegate：

  UNUserNotificationCenter.current().delegate = self
  

• 实现userNotificationCenter(_:willPresentNotification:withCompletionHandler:)方法时，需调用completionHandler并指定展示方式（即使app在前台）：

  func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
      completionHandler([.banner, .sound]) // iOS14+需指定.banner，而非.alert
  }
  

  iOS16中若未指定正确的展示选项，前台通知可能无法显示。

5. 排除iOS系统层面的限制 #

• 检查设备的专注模式：确保当前专注模式未屏蔽该app的通知（可在设置→专注中确认）。
• 确认app的通知权限：进入设置→通知→[你的app]，确保“允许通知”开启，且“横幅样式”设为“临时”或“持久”。

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