Flutter集成Firebase iOS推送通知失效，请求排查方案

1. 区分推送状态的不同表现 #

• 前台状态：Firebase Messaging默认不会在iOS前台弹出通知，只会触发onMessage回调。你当前的代码只打印了日志，测试时先看控制台是否有Got a message whilst in the foreground!的输出——如果有，说明推送已到达设备，只是需要用flutter_local_notifications手动弹出本地通知。
• 后台/应用杀死状态：需要确保推送消息包含notification字段（而非纯数据消息），同时Xcode的Background Modes中必须勾选Remote notifications（建议再次确认勾选状态）。

2. 验证APNs与Firebase的配置一致性 #

• 确认Firebase控制台中APNs认证密钥：
  • 密钥类型为Apple Push Notification service SSL (Sandbox & Production)，未过期。
  • 密钥关联的Team ID与Xcode项目中的Team ID完全一致。
• 重新下载GoogleService-Info.plist替换项目文件，避免缓存的旧配置干扰。
• 检查Xcode的Signing & Capabilities：Push Notifications功能状态为绿色（Xcode托管配置文件需确保自动同步了权限）。

3. 设备与系统层面检查 #

• 打开iPhone的设置->通知->你的应用：确认已开启通知权限，允许在锁定屏幕、横幅等位置显示，未开启“静默通知”限制。
• 确认测试设备的iOS版本兼容性：iPhone7支持的最高iOS版本为15.x，Firebase Messaging对该版本适配无问题，但需确保系统未禁用推送服务。

4. 用更精准的方式测试推送 #

• 直接测试APNs通道：使用APNs测试工具，输入设备token和APNs密钥发送测试推送。如果能收到，说明问题出在Firebase到APNs的转发环节；如果收不到，排查本地配置或设备权限。
• 用Firebase Admin SDK发送规范消息：避免控制台测试的不确定性，构造包含notification和iOS专属配置的消息，示例代码（Node.js）：

  const message = {
    token: "你的设备Token",
    notification: { title: "测试标题", body: "测试内容" },
    apns: {
      payload: {
        aps: { sound: "default", alert: { title: "测试标题", body: "测试内容" } }
      }
    }
  };
  

5. 补充代码逻辑覆盖全场景 #

• 后台与杀死状态的消息处理：添加监听代码捕获用户点击通知的行为：

  // 后台点击通知
  FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
    print("从后台打开通知: ${message.notification?.title}");
  });
  
  // 杀死状态下点击通知启动应用
  FirebaseMessaging.instance.getInitialMessage().then((RemoteMessage? message) {
    if (message != null) {
      print("从杀死状态启动应用: ${message.notification?.title}");
    }
  });
  

• 前台弹出通知：集成flutter_local_notifications库，在onMessage回调中手动触发本地通知：

  // 初始化本地通知插件
  final FlutterLocalNotificationsPlugin _notificationsPlugin = FlutterLocalNotificationsPlugin();
  
  Future<void> _initLocalNotifications() async {
    const iOSSettings = DarwinInitializationSettings(
      requestAlertPermission: false,
      requestBadgePermission: false,
      requestSoundPermission: false,
    );
    const initSettings = InitializationSettings(iOS: iOSSettings);
    await _notificationsPlugin.initialize(initSettings);
  }
  
  // 在onMessage中显示通知
  FirebaseMessaging.onMessage.listen((RemoteMessage message) {
    if (message.notification != null) {
      final notification = message.notification!;
      _notificationsPlugin.show(
        notification.hashCode,
        notification.title,
        notification.body,
        const NotificationDetails(
          iOS: DarwinNotificationDetails(),
        ),
      );
    }
  });
  

6. 日志排查关键线索 #

• 在Xcode控制台过滤APNs、FirebaseMessaging关键词，查看是否有推送相关的错误日志（如token获取失败、通知接收异常）。
• 查看Firebase控制台的Cloud Messaging -> 报告，检查消息的送达状态与错误提示。

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