FCM跨Android/iOS平台Payload编写求助：部分iPhone无通知弹窗

我之前调试FCM推送的时候也碰到过一模一样的情况——新iPhone和Android都能正常收通知，老款iPhone（6S/7/8/X这类）就是死活弹不出提醒。后来查了半天发现核心问题是FCM默认的notification字段在老iOS机型上，没法被APNs正确解析，得针对性调整Payload结构，同时兼顾双平台的推送标准。

方案一：增强版Notification+APNs专属配置（推荐，客户端无需额外改代码） #

直接在原有Payload里添加iOS专属的APNs配置，让老机型能识别到符合APNs标准的推送参数，不影响Android端的原有逻辑：

}).then(result => { 
  const token_id = result.val(); 
  const payload = {
    // Android端保持原有配置，完全不受影响
    notification: {
      title: "Message",
      body: `${userNameGlobal} has sent you a message`,
      sound: "default",
      priority: "high",
      icon: "default"
    },
    // 针对iOS老机型的APNs专属配置，必须添加
    apns: {
      payload: {
        aps: {
          alert: {
            title: "Message",
            body: `${userNameGlobal} has sent you a message`
          },
          sound: "default",
          badge: 0, // 即使不需要角标也得设值，老机型依赖这个字段识别推送类型
          "content-available": 1, // 唤醒App后台进程，确保通知能被系统处理
          priority: 5 // APNs高优先级，对应FCM的high级别
        }
      },
      headers: {
        "apns-push-type": "alert", // iOS13+要求，老机型兼容此设置
        "apns-priority": "5",
        "apns-topic": "你的App Bundle ID" // 一定要替换成你自己的App Bundle ID！
      }
    },
    // 可选：添加data字段，方便客户端拿到额外业务数据
    data: {
      sender: userNameGlobal,
      type: "message"
    }
  };
  return admin.messaging().sendToDevice(token_id, payload); 
}).then(response => { 
  console.log('Notification sent successfully.'); 
  return true; 
});

为什么这样改能解决问题？ #

• 老款iOS机型对FCM自动映射的notification字段支持有缺陷，直接在apns.payload.aps里写标准APNs参数，能绕过FCM的映射漏洞。
• apns.headers里的参数是APNs的硬性要求，尤其是apns-topic必须和你的App Bundle ID完全匹配，否则老机型会直接拒收推送。
• badge和content-available是老iOS系统识别推送的关键字段，缺少的话可能被系统判定为无效推送直接过滤。

方案二：纯Data推送+客户端本地通知（兼容性最强，需客户端配合） #

如果方案一还是没效果，可以用纯Data推送，让客户端自己处理通知显示——这种方式完全绕过FCM的自动通知逻辑，兼容性覆盖所有iOS/Android机型：

}).then(result => { 
  const token_id = result.val(); 
  const payload = {
    // 所有推送数据放在data里，由客户端自行解析处理
    data: {
      title: "Message",
      body: `${userNameGlobal} has sent you a message`,
      sound: "default",
      icon: "default",
      sender: userNameGlobal
    },
    // iOS端配置，确保能唤醒后台进程接收数据
    apns: {
      payload: {
        aps: {
          sound: "default",
          "content-available": 1,
          priority: 5
        }
      },
      headers: {
        "apns-push-type": "background",
        "apns-priority": "5",
        "apns-topic": "你的App Bundle ID"
      }
    },
    // Android端配置高优先级，确保能触发本地通知
    android: {
      priority: "high",
      notification: {
        sound: "default",
        icon: "default"
      }
    }
  };
  return admin.messaging().sendToDevice(token_id, payload); 
}).then(response => { 
  console.log('Data payload sent successfully.'); 
  return true; 
});

客户端需要配合做的事： #

• Android：在FirebaseMessagingService的onMessageReceived方法里，解析data字段后调用NotificationManager创建本地通知。
• iOS：在didReceiveRemoteNotification或者userNotificationCenter(_:didReceive:withCompletionHandler:)方法里，解析data并调用UNUserNotificationCenter显示本地通知。

额外注意事项 #

1. 检查iOS的APNs证书：老机型对证书的有效性更敏感，确保证书未过期、环境（开发/生产）和当前测试环境完全匹配。
2. 测试场景：老机型的App要处于后台或杀死状态测试，前台状态下iOS默认不会弹出通知，需要客户端自行处理显示逻辑。
3. 系统版本：如果是iOS 12及以下，确保apns-push-type字段设置正确，虽然iOS13才强制要求，但老机型设置后不会有兼容性问题。

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