Flutter集成Firebase推送通知iOS端无法正常工作排查

结合你的代码和配置情况，以下是可能遗漏的关键步骤：

• 未初始化Firebase
  你的AppDelegate中缺少Firebase初始化代码，iOS必须在启动时初始化Firebase才能使用云消息服务。在didFinishLaunchingWithOptions方法开头添加：

  FirebaseApp.configure()
  

• 未处理前台通知展示
  iOS 10及以上版本，当APP处于前台时，默认不会自动弹出通知。需要实现UNUserNotificationCenterDelegate的willPresentNotification方法，手动设置通知展示行为。在AppDelegate中添加：

  @available(iOS 10.0, *)
  override func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
      completionHandler([.alert, .badge, .sound])
  }
  

• 未开启后台通知权限
  在Xcode中，进入项目的Signing & Capabilities页面，开启Background Modes，并勾选Remote notifications选项，确保APP在后台能接收推送。

• 忽略了通知权限授权结果
  你的权限请求代码中没有处理用户是否允许通知，建议在requestAuthorization的回调中检查授权状态，确保用户已授予通知权限：

  UNUserNotificationCenter.current().requestAuthorization(
      options: authOptions,
      completionHandler: { granted, error in
          if granted {
              print("通知权限已授予")
          } else {
              print("通知权限被拒绝")
          }
      }
  )
  

• 未确认FCM Token是否成功注册
  仅设置APNS Token还不够，需要确保FCM Token已成功获取并注册到Firebase。可以添加监听获取FCM Token的代码：

  Messaging.messaging().token { token, error in
      if let error = error {
          print("获取FCM Token失败: \(error.localizedDescription)")
      } else if let token = token {
          print("FCM Token: \(token)")
      }
  }
  

• 环境与证书不匹配

  • 确保你使用的是真机测试，iOS模拟器不支持APNS推送。
  • 检查Firebase控制台上传的APN密钥/证书是否对应当前的环境（开发/生产），发送测试通知时要选择正确的环境，或勾选"使用APNS沙箱"选项（开发环境）。

• Flutter插件版本兼容性
  确认firebase_messaging插件版本与Flutter SDK版本兼容，建议更新到最新稳定版，避免因版本问题导致的推送异常。

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