# Android、Chrome、Firefox 错误排查

| 错误                      | 描述                                                                                                                                                                                                                                                                                                                             |      处理方法                                                                                                                                                                                                                                                                                                  |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **AuthenticationError**    | FCM 身份验证失败，因为凭据无效。                                                                                                                                                                                                                                                                                   | 检查 Pushwoosh 控制面板中指定的凭据、ServerKey 和 SenderID 是否正确。                                                                                                                                                                                                                                   |
| **DisabledFirebaseAPI**    | 在 FCM 控制台中，通过新的 HTTP v1 协议发送推送已被禁用。                                                                                                                                                                                                                                                             | 在 FCM 控制台中，使用新的 HTTP v1 协议启用推送通知发送功能。                                                                                                                                                                                                                         |
| **EmptyCredentials**       | 使用任何指定凭据发送推送通知失败。Pushwoosh 控制面板中指定的凭据无效。                                                                                                                                                                                                                       | 重新配置平台（_设置_ → _配置平台_）。                                                                                                                                                                                                                                                |
| **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 控制面板中重新配置平台，并重新上传包含凭据的 JSON。                                                                                                                                                                                                                                                |
| **InvalidRegistration**    | 推送令牌无效；设备将取消订阅通知。                                                                                                                                                                                                                                                          | 使用有效的令牌，并检查您是否已在设备上启用来自应用的通知。                                                                                                                                                                                                                                           |
| **MessageTooBig**          | 消息大小超过 4096 字节的 FCM 限制。                                                                                                                                                                                                                                                                                          | 减小您发送的消息大小。                                                                                                                                                                                                                                                                     |
| **MistmatchSenderId**      | <p>此错误可能由以下原因之一引起：</p><ul><li>您的应用中指定的 Sender ID 与在 Pushwoosh 控制面板中配置平台时指定的 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>设备的推送令牌已过期。</li></ul>                                                                                        | 尝试使用新令牌。                                                                                                                                                                                                                                                                                       |
| **PermissionDenied**       | Pushwoosh 控制面板中指定的凭据未授予发送推送通知的权限。这意味着无法从该 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 控制面板中配置平台时指定的 Sender ID 不匹配。</li><li>您的应用中的 Sender ID 与您使用的 FCM 凭据关联的 Sender ID 不匹配。</li></ul> | 确保您在应用和 Pushwoosh 平台配置中使用了 Firebase Console 中的有效 Sender ID。                                                                                                                                                                                       |
| **TokenIsEmpty**           | <p>以下原因可能导致此错误：</p><ul><li>设备没有令牌。</li><li>注册设备时未传输令牌。</li><li>发送请求时，设备没有令牌，但由于某种原因，它被传输到我们的设备数据库。</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>设备的推送令牌已过期。</li></ul>                                                                                 | 尝试使用新令牌。                                                                                                                                                                                                                                                                                       |
| **UnsupportedTokenType**   | 令牌无效；设备将取消订阅通知。                                                                                                                                                                                                                                                                | 使用有效的令牌。                                                                                                                                                                                                                                                                                         |