跳到内容

Android、Chrome、Firefox 错误

当 Pushwoosh 向 Android、Chrome 或 Firefox 设备发送推送通知时,这些错误来自 Firebase Cloud Messaging (FCM)。

错误描述如何处理
AuthenticationError由于凭据无效,FCM 身份验证失败。请检查在 Pushwoosh Control Panel 中指定的凭据、ServerKey 和 SenderID 是否正确。
DisabledFirebaseAPI在 FCM 控制台中,通过新的 HTTP v1 协议发送推送的功能已被禁用。在 FCM 控制台中启用使用新的 HTTP v1 协议发送推送通知。
EmptyCredentials使用任何指定的凭据发送推送通知均失败。在 Pushwoosh Control Panel 中指定的凭据无效。重新配置平台(Settings → Configure platform)。
FCMInternalServerErrorFCM 未能将消息发送到设备。这通常意味着 FCM 服务暂时不可用。请稍后重试。
FrequencyCapping设备已被频率上限过滤。如果此行为非预期,请检查频率上限设置。
InternalServerErrorFCM 未能将消息发送到设备。这通常意味着 FCM 服务暂时不可用。请稍后重试。
InvalidCredentials在配置平台时,您添加了包含不正确 FCM 凭据的 JSON,或指定了不正确的 SenderID 或 ServerKey。使用来自 FCM 控制台的正确凭据、SenderID 和 ServerKey 重新配置平台。
InvalidEndpoint这是一个内部 FCM 错误,意味着推送被发送到了一个无效地址。请稍后重试。
InvalidPrivateKey在 FCM 凭据的 private_key 字段中指定的私钥结构无效。在 Pushwoosh Control Panel 中重新配置平台,并重新上传包含凭据的 JSON 文件。
InvalidRegistration推送令牌无效;设备将从通知中被取消订阅。请使用有效的令牌,并检查您是否已在设备上为您的应用启用了通知。
MessageTooBig消息大小超过了 4096 字节的 FCM 限制。请减小您发送的消息的大小。
MistmatchSenderId

出现此错误的原因如下之一:

  • 您应用中指定的发送者 ID 与在 Pushwoosh Control Panel 中配置平台时指定的发送者 ID 不匹配。
  • 您应用中的发送者 ID 与您使用的 FCM 凭据关联的发送者 ID 不匹配。
请确保您在应用程序和 Pushwoosh 平台配置中使用了来自 Firebase Console 的有效发送者 ID。
NotFound这是一个内部 FCM 错误,意味着 FCM 服务当前不可用。请稍后重试。
NotRegistered

设备未注册。此状态意味着以下情况之一:

  • 设备已从通知中取消订阅;
  • 应用程序已从设备中删除;
  • 设备的推送令牌已过期。
请尝试使用新的令牌。
PermissionDenied在 Pushwoosh Control Panel 中指定的凭据没有授予发送推送通知的权限。这意味着无法从此 FCM 账户发送推送通知。根据 Firebase 文档获取具有正确权限的凭据。在生成用于发送消息的凭据时,您必须拥有 Firebase Admin 角色或具有 ‘cloudmessaging.messages.create’ 权限的角色。
SenderIDMistmatch

出现此错误的原因如下之一:

  • 您应用中指定的发送者 ID 与在 Pushwoosh Control Panel 中配置平台时指定的发送者 ID 不匹配。
  • 您应用中的发送者 ID 与您使用的 FCM 凭据关联的发送者 ID 不匹配。
请确保您在应用程序和 Pushwoosh 平台配置中使用了来自 Firebase Console 的有效发送者 ID。
TokenIsEmpty

以下原因可能导致此错误:

  • 设备没有令牌。
  • 注册设备时未传输令牌。
  • 发送请求时,设备没有令牌,但由于某种原因,它被传输到了我们的设备数据库中。
如果您频繁看到此错误,请联系我们的客户支持团队。
Unavailable多次尝试后未能将消息发送到 FCM。这通常意味着 FCM 服务暂时不可用。

请稍后重试。

如果您频繁看到此错误,请联系我们的客户支持团队。

Unregistered

设备未注册。此状态意味着以下情况之一:

  • 设备已从通知中取消订阅;
  • 应用程序已从设备中删除;
  • 设备的推送令牌已过期。
请尝试使用新的令牌。
UnsupportedTokenType令牌无效;设备将从通知中被取消订阅。请使用有效的令牌。