跳到内容

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 中指定的凭据无效。重新配置平台(SettingsConfigure 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令牌无效;设备将从通知中被取消订阅。请使用有效的令牌。