部分iOS设备已启用通知仍无法接收FCM推送问题排查

我之前也碰到过iOS端FCM通知部分设备收不到的情况，结合你给出的请求内容，咱们一步步来排查和解决：

1. APNs证书与环境不匹配 #

iOS的FCM通知底层依赖APNs，这是最容易出问题的环节：

• 检查Firebase控制台里的APNs配置：确认上传的证书是开发环境（Sandbox）还是生产环境（Production），设备的FCM Token是对应环境生成的——如果用生产证书发送给开发环境的Token，肯定收不到。
• 证书有效性：确保证书没过期，Bundle ID、Team ID和Firebase项目里的配置完全一致，并且证书已经开启了「Push Notification」权限。

2. 自定义Notification字段导致的兼容性问题 #

你的请求里notification字段包含了deepLink，但FCM的标准notification字段里并没有这个属性！iOS的APNs会过滤掉非标准字段，可能导致整个通知被系统拦截。

• 建议把deepLink移到data字段里，然后在iOS客户端的通知回调方法（比如didReceiveRemoteNotification）里读取这个字段，手动处理跳转逻辑。

3. Content_available与Notification字段的冲突 #

你设置了content_available: true，这个参数是用来触发静默通知（不显示通知栏，仅触发后台回调）的，但同时又携带了notification字段（用于显示通知栏），这种混合配置在iOS上行为会不稳定：

• 如果你的需求是显示通知栏，建议把content_available设为false；如果需要后台唤醒APP处理逻辑，就去掉notification字段，只保留data和content_available: true。

4. 设备Token有效性问题 #

虽然部分设备能收到，但还是要确认收不到的设备Token是否有效：

• Token可能因为APP卸载、设备刷机、系统更新等原因失效，建议在客户端监听Token刷新事件，确保发送的是最新的Token；也可以通过FCM的反馈机制排查Token状态。

5. iOS客户端通知权限与回调配置 #

即使用户开启了系统通知，APP内部的配置也可能有问题：

• 确认客户端已经正确请求了alert、sound等通知权限（iOS 10+需要用UNUserNotificationCenter请求）；
• 如果APP在前台运行，iOS默认不会显示通知栏，需要在willPresentNotification方法里返回.alert才能让通知显示出来；
• 确保客户端实现了必要的通知回调方法，避免因未处理通知导致系统丢弃消息。

针对显示通知栏的场景，调整后的请求可以这样写：

{
  "to": "TOKEN HERE",
  "priority": "high",
  "notification": {
    "title": "Second Key",
    "body": "Test Body",
    "sound": "default"
  },
  "data": {
    "title": "Test Title",
    "body": "Test Body",
    "deepLink": "https://google.com"
  }
}

如果需要后台静默唤醒APP处理逻辑，请求可以改成：

{
  "to": "TOKEN HERE",
  "priority": "high",
  "content_available": true,
  "data": {
    "title": "Test Title",
    "body": "Test Body",
    "deepLink": "https://google.com"
  }
}

先从APNs证书和Token有效性开始排查，这两个是最常见的根源，再逐步检查请求字段和客户端配置，应该能解决大部分问题。

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