跳到内容
开发者文档支持 请求演示 登录
Pushwoosh.com

Android、Chrome、Firefox 错误

错误描述应对措施
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 文件。
InvalidRegistrationPush token 无效；设备将从通知中被取消订阅。请使用有效的 token，并检查您是否已在设备上为您的应用启用了通知。
MessageTooBig消息大小超过了 FCM 4096 字节的限制。请减小您发送的消息的大小。
MistmatchSenderId

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

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

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

  • 设备已从通知中取消订阅；
  • 应用程序已从设备中删除；
  • 设备的 push 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

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

  • 设备已从通知中取消订阅；
  • 应用程序已从设备中删除；
  • 设备的 push token 已过期。
请尝试使用新的 token。
UnsupportedTokenTypeToken 无效；设备将从通知中被取消订阅。请使用有效的 token。