跳到内容
用户指南 操作指南 支持 请求演示 登录
Pushwoosh.com

Android、Chrome、Firefox 错误排查

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

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

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

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

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

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

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

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

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

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

请稍后重试。

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

Unregistered

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

  • 设备已从通知中退订；
  • 应用程序已从设备中删除；
  • 设备的推送 token 已过期。
尝试使用新的 token。
UnsupportedTokenTypetoken 无效；设备将从通知中退订。使用有效的 token。