Firebase Console无法向iOS应用推送通知，服务器推送正常求助

核心排查点（按优先级排序） #

• 确认控制台通知的目标配置
  发送通知时需检查：

  • 若选择「用户分段」，需保证分段包含测试设备对应的用户；
  • 若选择「单个设备」，必须输入iOS设备的有效FCM令牌（而非APNS令牌），且该令牌未过期、未被应用注销。

• 校验APNS环境一致性
  服务器推送正常说明密钥/证书有效，但要匹配环境：

  • 测试设备若处于调试模式（连接Xcode），Firebase需配置对应开发环境的APNS证书，或使用支持双环境的APNS密钥；
  • 前往项目设置 > 云消息传递 > iOS应用，确认「APNS环境」设置与测试设备环境一致（开发/生产）。

• 检查应用通知权限与后台配置
  iOS端需满足：

  • 测试设备已给应用授予通知权限（系统设置→对应应用→通知中确认）；
  • Xcode中开启Capabilities > Background Modes > Remote notifications权限；
  • 若控制台发送静默通知，需确保AppDelegate或UNUserNotificationCenterDelegate正确处理静默回调逻辑。

• 排查控制台通知内容格式
  避免触发APNS限制：

  • 通知标题、内容不含iOS禁止的特殊字符，且长度符合APNS要求；
  • 自定义数据（Custom data）的键名不能与APNS保留键重复，格式需为合法的键值对。

• 验证FCM与APNS令牌绑定状态

  • 前往Firebase Console「用户与设备」板块，检查测试设备的FCM令牌是否关联了正确的APNS令牌；
  • 若应用近期更新过令牌，确认新令牌已同步到Firebase服务器。

内容的提问来源于stack exchange，提问作者Muhammad Wazzah Iftikhar