iOS下.p8格式APNs证书对接Firebase推送失败排查求助

结合你已经完成的操作（纠正Key Name/Key Id混淆、移除App ID中的.p12证书），咱们从几个核心方向继续排查问题：

1. 再次核对.p8证书的基础配置细节 #

• Key ID与Team ID必须精准匹配：再确认一遍Firebase控制台里填的Key ID是苹果开发者后台生成Auth Key时的10位字符串（不是你给Key起的自定义名称）；Team ID是你苹果开发者账号的专属ID，在Apple Developer Account的「Membership」页面就能找到。
• Auth Key的权限不能漏选：生成.p8文件时，必须勾选Apple Push Notification service (APNs)权限，这个Key是绑定你的开发者账号的，跨账号使用会直接认证失败。如果当时没选，赶紧重新生成一个权限正确的.p8文件。
• Firebase控制台要彻底清理旧配置：除了App ID里的.p12，还要检查Firebase「Cloud Messaging」页面，确保只保留.p8相关的配置项（Key ID、Team ID、上传的.p8文件），不要同时存在两种证书的配置。

2. 检查Firebase SDK版本的兼容性 #

你当前用的FirebaseMessaging 2.0.8版本非常老旧，这类早期版本的SDK对.p8证书的支持可能存在兼容性问题，尤其是APNs认证逻辑的适配。建议升级到稳定的新版本，比如：

# Podfile里修改依赖版本
FirebaseMessaging (~> 10.0)
FirebaseAnalytics (~> 10.0)
FirebaseCore (~> 10.0)
FirebaseInstanceID (~> 10.0)

升级后记得执行pod deintegrate清理旧缓存，再重新pod install，编译测试。

3. 调整推送Payload的格式（适配iOS 13+要求） #

你当前用的Payload在Debug模式下可能不符合iOS 13+的APNs规范，建议修改为包含apns-push-type的格式：

{
  "to": "fcm-token",
  "notification": {
    "body": "test",
    "title": "title1"
  },
  "apns": {
    "headers": {
      "apns-push-type": "alert",
      "apns-priority": "10"
    }
  }
}

另外要注意：苹果生成的Auth Key默认支持Sandbox和Production双环境，Debug模式下Firebase会自动切换到Sandbox环境，不用额外配置。

4. 获取更详细的错误日志定位问题 #

Firebase控制台的提示太笼统，你可以通过这两个方式拿到具体错误：

• Xcode控制台日志：运行项目时，搜索APNs或Messaging关键词，看有没有认证失败的具体报错（比如authentication failed、invalid token等）。
• Firebase推送报告：登录Firebase「Cloud Messaging」->「Reports」页面，查看推送的错误详情，里面会显示APNs返回的具体错误码（比如403表示权限问题，400表示Payload格式错误）。

5. 重新生成FCM Token测试 #

虽然.p12时Token可用，但切换认证方式后，设备的FCM Token可能需要重新生成。在App启动时调用以下代码获取新Token，用新Token测试推送：

Messaging.messaging().token { token, error in
  if let error = error {
    print("获取FCM Token失败: \(error)")
  } else if let token = token {
    print("新的FCM Token: \(token)")
    // 用这个Token测试推送
  }
}

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