Android、Chrome、Firefox 错误排查

错误	描述	处理方法
AuthenticationError	FCM 身份验证失败，因为凭据无效。	检查 Pushwoosh 控制面板中指定的凭据、ServerKey 和 SenderID 是否正确。
DisabledFirebaseAPI	在 FCM 控制台中，通过新的 HTTP v1 协议发送推送已被禁用。	在 FCM 控制台中，使用新的 HTTP v1 协议启用推送通知发送功能。
EmptyCredentials	使用任何指定凭据发送推送通知失败。Pushwoosh 控制面板中指定的凭据无效。	重新配置平台（设置 → 配置平台）。
FCMInternalServerError	FCM 未能将消息传递到设备。这通常意味着 FCM 服务暂时不可用。	稍后重试。
FrequencyCapping	设备被 频率限制 过滤。	如果这不是预期行为，请检查 频率限制 设置。
InternalServerError	FCM 未能将消息传递到设备。这通常意味着 FCM 服务暂时不可用。	稍后重试。
InvalidCredentials	配置平台时，您添加了包含 FCM 凭据的错误 JSON，或指定了错误的 SenderID 或 ServerKey。	使用 FCM 控制台中正确的凭据、SenderID 和 ServerKey 重新配置平台。
InvalidEndpoint	这是一个内部 FCM 错误，意味着推送被发送到无效地址。	稍后重试。
InvalidPrivateKey	FCM 凭据中 private_key 字段指定的私钥结构无效。	在 Pushwoosh 控制面板中重新配置平台，并重新上传包含凭据的 JSON。
InvalidRegistration	推送令牌无效；设备将取消订阅通知。	使用有效的令牌，并检查您是否已在设备上启用来自应用的通知。
MessageTooBig	消息大小超过 4096 字节的 FCM 限制。	减小您发送的消息大小。
MistmatchSenderId	此错误可能由以下原因之一引起： 您的应用中指定的 Sender ID 与在 Pushwoosh 控制面板中配置平台时指定的 Sender ID 不匹配。 您的应用中的 Sender ID 与您使用的 FCM 凭据关联的 Sender ID 不匹配。	确保您在应用和 Pushwoosh 平台配置中使用了 Firebase Console 中的有效 Sender ID。
NotFound	这是一个内部 FCM 错误，意味着 FCM 服务当前不可用。	稍后重试。
NotRegistered	设备未注册。此状态意味着以下情况之一： 设备已取消订阅通知； 应用已从设备中删除； 设备的推送令牌已过期。	尝试使用新令牌。
PermissionDenied	Pushwoosh 控制面板中指定的凭据未授予发送推送通知的权限。这意味着无法从该 FCM 账户发送推送通知。	根据 Firebase 文档 获取具有正确权限的凭据。生成发送消息的凭据时，您必须拥有 Firebase Admin 角色或具有 ‘cloudmessaging.messages.create’ 权限的角色。
SenderIDMistmatch	此错误可能由以下原因之一引起： 您的应用中指定的 Sender ID 与在 Pushwoosh 控制面板中配置平台时指定的 Sender ID 不匹配。 您的应用中的 Sender ID 与您使用的 FCM 凭据关联的 Sender ID 不匹配。	确保您在应用和 Pushwoosh 平台配置中使用了 Firebase Console 中的有效 Sender ID。
TokenIsEmpty	以下原因可能导致此错误： 设备没有令牌。 注册设备时未传输令牌。 发送请求时，设备没有令牌，但由于某种原因，它被传输到我们的设备数据库。	如果您经常看到此错误，请联系我们的 客户支持团队。
Unavailable	多次尝试后，未能将消息发送到 FCM。这通常意味着 FCM 服务暂时不可用。	稍后重试。 如果您经常看到此错误，请联系我们的 客户支持团队。
Unregistered	设备未注册。此状态意味着以下情况之一： 设备已取消订阅通知； 应用已从设备中删除； 设备的推送令牌已过期。	尝试使用新令牌。
UnsupportedTokenType	令牌无效；设备将取消订阅通知。	使用有效的令牌。