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）。
FCMInternalServerError	FCM 未能将消息送达到设备。这通常意味着 FCM 服务暂时不可用。	请稍后重试。
FrequencyCapping	设备被频率上限过滤。	如果此行为非预期，请检查频率上限设置。
InternalServerError	FCM 未能将消息送达到设备。这通常意味着 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。
UnsupportedTokenType	token 无效；设备将从通知中退订。	使用有效的 token。