You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

通过Firebase发送iOS推送提示InvalidApnsCredential,已添加auth key与证书

FCM调用iOS推送报错InvalidApnsCredential排查方案

错误返回示例:

multicast_id:213242345
success: 0,
failure: 1,
canonical_ids: 0,
results: [ { error: 'InvalidApnsCredential' } ]

该错误本质为FCM无法通过你配置的凭证完成APNs服务鉴权,可按以下步骤逐一排查:

  • 校验APNs Auth Key核心参数一致性
    • 确认上传到FCM的Auth Key对应的Team ID、Key ID、Bundle ID和苹果开发者后台的配置完全匹配,Bundle ID区分大小写,不可多填/漏填环境后缀(如.debug、.test等)
    • 确认.p8凭证文件和苹果开发者后台下载的原始文件完全一致,没有被修改、损坏,且该Auth Key未在苹果后台被吊销、对应开发者账号权限正常
  • 检查推送环境与应用签名匹配性
    • 测试包(Xcode直接编译、Development签名)推送必须选择开发环境,正式包(App Store、TestFlight、Ad Hoc分发)推送必须选择生产环境,环境不匹配会直接触发鉴权失败
    • 若使用Auth Key方式配置,本身支持开发和生产双环境,不需要单独上传两个凭证,只要请求时的环境参数选对即可
    • 若使用证书而非Auth Key配置,要确保证书类型和推送环境对应:开发证书仅可用于开发环境推送,生产证书仅可用于生产环境推送,且证书未过期、未被吊销
  • 核对FCM项目与请求参数正确性
    • 确认你调用FCM接口的项目和上传APNs凭证的FCM项目为同一个,避免跨项目调用
    • 若近期更新过APNs凭证,需等待5-10分钟让配置生效后再测试
    • 确认请求携带的device token与当前推送环境匹配,不能混用开发/生产环境的token,也不能使用其他应用的token

内容的提问来源于stack exchange,提问作者Farrukh Atabekov

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.01 10:57:04