# Android、Chrome、Firefox 错误

| 错误 | 描述 | 应对措施 |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **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** | 设备被[频次上限](/zh/product/messaging-channels/global-frequency-capping)过滤。 | 如果此行为非预期，请检查[频次上限](/zh/product/messaging-channels/global-frequency-capping)设置。 |
| **InternalServerError** | FCM 未能将消息送达到设备。这通常意味着 FCM 服务暂时不可用。 | 请稍后重试。 |
| **InvalidCredentials** | 在配置平台时，您添加了包含 FCM 凭据的错误 JSON，或指定了不正确的 SenderID 或 ServerKey。 | 请使用 FCM 控制台提供的正确凭据、SenderID 和 ServerKey 重新配置平台。 |
| **InvalidEndpoint** | 这是一个内部 FCM 错误，意味着推送被发送到了一个无效地址。 | 请稍后重试。 |
| **InvalidPrivateKey** | 在 FCM 凭据的 _private\_key_ 字段中指定的私钥结构无效。 | 请在 Pushwoosh Control Panel 中重新配置平台，并重新上传包含凭据的 JSON 文件。 |
| **InvalidRegistration** | Push token 无效；设备将从通知中被取消订阅。 | 请使用有效的 token，并检查您是否已在设备上为您的应用启用了通知。 |
| **MessageTooBig** | 消息大小超过了 FCM 4096 字节的限制。 | 请减小您发送的消息的大小。 |
| **MistmatchSenderId** | <p>出现此错误的原因如下之一：</p><ul><li>您应用中指定的 sender ID 与在 Pushwoosh Control Panel 中配置平台时指定的 sender ID 不匹配。</li><li>您应用中的 sender ID 与您使用的 FCM 凭据关联的 sender ID 不匹配。</li></ul> | 请确保您在应用程序和 Pushwoosh 平台配置中都使用了来自 Firebase Console 的有效 sender ID。 |
| **NotFound** | 这是一个内部 FCM 错误，意味着 FCM 服务当前不可用。 | 请稍后重试。 |
| **NotRegistered** | <p>设备未注册。此状态意味着以下情况之一：</p><ul><li>设备已从通知中取消订阅；</li><li>应用程序已从设备中删除；</li><li>设备的 push token 已过期。</li></ul> | 请尝试使用新的 token。 |
| **PermissionDenied** | 在 Pushwoosh Control Panel 中指定的凭据没有授予发送推送通知的权限。这意味着无法从此 FCM 账户发送推送通知。 | 请根据 [Firebase 文档](https://firebase.google.com/docs/projects/iam/permissions)获取具有正确权限的凭据。在生成用于发送消息的凭据时，您必须拥有 Firebase Admin 角色或具有 _‘cloudmessaging.messages.create’_ 权限的角色。 |
| **SenderIDMistmatch** | <p></p><p>出现此错误的原因如下之一：</p><ul><li>您应用中指定的 sender ID 与在 Pushwoosh Control Panel 中配置平台时指定的 sender ID 不匹配。</li><li>您应用中的 sender ID 与您使用的 FCM 凭据关联的 sender ID 不匹配。</li></ul> | 请确保您在应用程序和 Pushwoosh 平台配置中都使用了来自 Firebase Console 的有效 sender ID。 |
| **TokenIsEmpty** | <p>以下原因可能导致此错误：</p><ul><li>设备没有 token。</li><li>注册设备时未传输 token。</li><li>发送请求时，设备没有 token，但由于某种原因，它被传输到了我们的设备数据库中。</li></ul> | 如果您频繁看到此错误，请联系我们的[客户支持团队](https://help.pushwoosh.com/hc/en-us/requests/new/?utm\_content=docs\&utm\_term=post\&utm\_campaign=android-chrome-firefox-errors)。 |
| **Unavailable** | 多次尝试后未能将消息发送到 FCM。这通常意味着 FCM 服务暂时不可用。 | <p>请稍后重试。 </p><p></p><p>如果您频繁看到此错误，请联系我们的<a href="https://help.pushwoosh.com/hc/en-us/requests/new/?utm_content=docs&#x26;utm_term=post&#x26;utm_campaign=android-chrome-firefox-errors">客户支持团队</a>。</p> |
| **Unregistered** | <p></p><p>设备未注册。此状态意味着以下情况之一：</p><ul><li>设备已从通知中取消订阅；</li><li>应用程序已从设备中删除；</li><li>设备的 push token 已过期。</li></ul> | 请尝试使用新的 token。 |
| **UnsupportedTokenType** | Token 无效；设备将从通知中被取消订阅。 | 请使用有效的 token。 |