iOS 17.2.1下FCM通知在App关闭时无法接收的问题求助

问题现象 #

• App前台/后台状态下FCM通知正常送达
• iOS 17.2.1设备上App彻底关闭（向上滑动退出）后无法收到通知，仅重启App后通过服务器查询才显示
• iOS 16.7、17.1/17.2及Android设备无此问题

排查与解决方案 #

1. 调整推送消息的APNs优先级 #

iOS 17.2.1对后台/关闭状态下的通知优先级要求更严格，需确保推送请求中设置高优先级：
在FCM v1请求的apns字段中添加headers配置，设置apns-priority为10：

{
  "message": {
    "token": "USER_TOKEN",
    "notification": {
      "title": "Test Title",
      "body": "Body of the notification"
    },
    "data": {
      "message_body": "This is a noti"
    },
    "apns": {
      "headers": {
        "apns-priority": "10"
      }
    }
  }
}

高优先级通知会被APNs优先投递，即使App处于关闭状态。

2. 检查APNs环境与证书配置 #

确保FCM使用的APNs证书/密钥与当前运行环境（开发/生产）完全匹配：

• 开发环境用开发证书，生产环境用生产证书
• 确认密钥未过期，且已在Apple开发者后台启用推送权限
  iOS 17.2.1可能对证书的有效性校验更严格，任何不匹配都可能导致关闭状态下的通知被拦截。

3. 测试纯Notification类型消息 #

暂时移除data字段，发送仅包含notification的消息：

{
  "message": {
    "token": "USER_TOKEN",
    "notification": {
      "title": "Test Title",
      "body": "Body of the notification"
    },
    "apns": {
      "headers": {
        "apns-priority": "10"
      }
    }
  }
}

部分iOS版本在混合发送notification+data消息时，关闭状态下可能仅触发data消息的处理逻辑（需要App启动），纯notification消息由APNs直接展示，不受App状态影响。

4. 验证iOS系统通知设置 #

确认设备上的通知设置完全开启：

• 进入「设置」>「通知」> 你的App
• 开启「允许通知」
• 确保「锁定屏幕」「通知中心」「横幅」全部勾选
• 检查「通知分组」「声音」等选项未被限制
  虽然其他版本正常，但iOS 17.2.1可能新增了某些隐性权限限制。

5. 查看FCM与APNs推送日志 #

在FCM控制台或服务器端查看推送请求的返回结果：

• 检查是否有APNs返回的错误码（如InvalidToken、DeviceTokenNotForTopic）
• 确认推送请求状态为success，无延迟或拒绝记录
  如果发现错误，根据错误码调整配置（如重新获取有效token、修正topic配置）。

6. 确认App的FCM注册逻辑 #

确保App启动时（包括冷启动）正确注册FCM token，并将最新token同步到服务器：

• iOS 17.2.1可能在App关闭后token发生变更，若服务器未更新旧token，推送会失败
• 实现didRefreshRegistrationToken方法，及时同步新token到服务器

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