Admin FCM API 错误

以下是 Firebase Admin FCM API 引发的错误代码的完整列表(包括说明和推荐的解决步骤):

错误代码 说明和解决步骤
messaging/invalid-argument 向 FCM 方法提供的参数无效。错误消息中应该会包含更多信息。
messaging/invalid-recipient 预期的消息接收者无效。错误消息中应该会包含更多信息。要了解如何向各类接收者正确发送消息,请参阅发送消息
messaging/invalid-payload 提供的消息负载对象无效。错误消息中应该会包含更多信息。要了解如何正确定义消息负载,请参阅定义消息负载
messaging/invalid-data-payload-key 数据消息负载包含无效键。要了解受限制的键,请参阅 DataMessagePayload 的参考文档。
messaging/payload-size-limit-exceeded 提供的消息负载超出了 FCM 大小限制。对于大多数消息,此限制为 4096 字节。对于发送到主题的消息,此限制为 2048 字节。键和值都会计入负载总大小。
messaging/invalid-options 提供的消息选项对象无效。错误消息中应该会包含更多信息。如需详细了解如何正确定义消息选项,请参阅定义消息选项
messaging/invalid-registration-token 提供的注册令牌无效。请确保它与客户端应用在注册 FCM 时获得的注册令牌相符。不要截断或添加其他字符。
messaging/registration-token-not-registered 提供的注册令牌未注册。以前有效的注册令牌可能会因多种原因而被取消注册,其中包括:
  • 客户端应用自身取消 FCM 注册。
  • 客户端应用被自动取消注册。如果用户卸载该应用,或者在 iOS 中,APNs 反馈服务报告称 APNs 令牌无效,就可能会发生这种情况。
  • 注册令牌已过期。例如,Google 可能决定更新注册令牌,或 iOS 设备的 APNs 令牌可能已过期。
  • 客户端应用已更新,但新版本未配置为接收消息。
对于所有这些情况,请移除此注册令牌,并停止用其发送消息。
messaging/invalid-package-name 消息中指定的接收方注册令牌的软件包名称与提供的 restrictedPackageName 选项不符。
messaging/message-rate-exceeded 向特定目标发送消息的频率过高。请减少发送到此设备或主题的消息数,且不要立即重试向此目标发送消息。
messaging/device-message-rate-exceeded 向特定设备发送消息的频率过高。请减少发送到此设备的消息数,且不要立即重试向此设备发送消息。
messaging/topics-message-rate-exceeded 向特定主题的订阅者发送消息的频率过高。请减少发送到此主题的消息数,且不要立即重试向此主题发送消息。
messaging/too-many-topics 注册令牌订阅的主题数量已达到上限,无法订阅更多主题。
messaging/invalid-apns-credentials 因为所需的 APNs SSL 证书尚未上传或已过期,所以无法向 iOS 设备发送消息。请检查您的开发环境证书和生产环境证书是否有效。
messaging/mismatched-credential 用于对此 SDK 进行身份验证的凭据无权向所提供的注册令牌对应的设备发送消息。请确保相应凭据和注册令牌均属于同一个 Firebase 项目。要了解如何对 Admin SDK 进行身份验证,请参阅将 Firebase 添加至您的应用
messaging/authentication-error SDK 无法向 FCM 服务器验证身份。请确保您使用具有适当权限来发送 FCM 消息的凭据对 Admin SDK 进行身份验证。要了解如何对 Admin SDK 进行身份验证,请参阅将 Firebase 添加至您的应用
messaging/server-unavailable FCM 服务器无法及时处理请求。您应该重试同一个请求,但必须:
  • 如果 FCM 连接服务器发出的响应中包含 Retry-After 标头,则应在该标头指明的间隔后重试。
  • 在您的重试机制中实现指数退避。例如,如果等待一秒钟后进行第一次重试,则至少要等待两秒钟再进行下一次重试,然后等待四秒钟,依此类推。如果您要发送多条消息,请分别将每条消息延迟额外的随机时长,从而避免同时为所有消息发出新的请求。
导致出现问题的发送者有可能会被列入黑名单。
messaging/internal-error FCM 服务器在尝试处理请求时遇到错误。您可按照上一行 messaging/server-unavailable 中列出的要求重试同一请求。如果错误持续存在,请向我们的错误报告支持渠道报告该问题。
messaging/unknown-error 返回了未知的服务器错误。如需了解详情,请参阅错误消息中的原始服务器响应。如果您看到此错误,请向我们的错误报告支持渠道报告完整的错误消息。

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面