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 中指定的凭据无效。 | 重新配置平台(Settings → Configure platform)。 |
| FCMInternalServerError | FCM 未能将消息发送到设备。这通常意味着 FCM 服务暂时不可用。 | 请稍后重试。 |
| FrequencyCapping | 设备已被频率上限过滤。 | 如果此行为非预期,请检查频率上限设置。 |
| InternalServerError | FCM 未能将消息发送到设备。这通常意味着 FCM 服务暂时不可用。 | 请稍后重试。 |
| InvalidCredentials | 在配置平台时,您添加了包含不正确 FCM 凭据的 JSON,或指定了不正确的 SenderID 或 ServerKey。 | 使用来自 FCM 控制台的正确凭据、SenderID 和 ServerKey 重新配置平台。 |
| InvalidEndpoint | 这是一个内部 FCM 错误,意味着推送被发送到了一个无效地址。 | 请稍后重试。 |
| InvalidPrivateKey | 在 FCM 凭据的 private_key 字段中指定的私钥结构无效。 | 在 Pushwoosh Control Panel 中重新配置平台,并重新上传包含凭据的 JSON 文件。 |
| InvalidRegistration | 推送令牌无效;设备将从通知中被取消订阅。 | 请使用有效的令牌,并检查您是否已在设备上为您的应用启用了通知。 |
| MessageTooBig | 消息大小超过了 4096 字节的 FCM 限制。 | 请减小您发送的消息的大小。 |
| MistmatchSenderId | 出现此错误的原因如下之一:
| 请确保您在应用程序和 Pushwoosh 平台配置中使用了来自 Firebase Console 的有效发送者 ID。 |
| NotFound | 这是一个内部 FCM 错误,意味着 FCM 服务当前不可用。 | 请稍后重试。 |
| NotRegistered | 设备未注册。此状态意味着以下情况之一:
| 请尝试使用新的令牌。 |
| PermissionDenied | 在 Pushwoosh Control Panel 中指定的凭据没有授予发送推送通知的权限。这意味着无法从此 FCM 账户发送推送通知。 | 根据 Firebase 文档获取具有正确权限的凭据。在生成用于发送消息的凭据时,您必须拥有 Firebase Admin 角色或具有 ‘cloudmessaging.messages.create’ 权限的角色。 |
| SenderIDMistmatch | 出现此错误的原因如下之一:
| 请确保您在应用程序和 Pushwoosh 平台配置中使用了来自 Firebase Console 的有效发送者 ID。 |
| TokenIsEmpty | 以下原因可能导致此错误:
| 如果您频繁看到此错误,请联系我们的客户支持团队。 |
| Unavailable | 多次尝试后未能将消息发送到 FCM。这通常意味着 FCM 服务暂时不可用。 | 请稍后重试。 如果您频繁看到此错误,请联系我们的客户支持团队。 |
| Unregistered | 设备未注册。此状态意味着以下情况之一:
| 请尝试使用新的令牌。 |
| UnsupportedTokenType | 令牌无效;设备将从通知中被取消订阅。 | 请使用有效的令牌。 |