# iOS、macOS、Safari 错误排查

| 错误                      | 描述                                                                                                                                                                                | 操作                                                                                                                                                                                                                                                                                                                           |
| :------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **BadCertificate**        | 此应用程序的 APNS 证书无效。                                                                                                                                                        | 使用 [此指南](/zh/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#generating-a-certificate-request-file) 创建有效证书，并检查平台配置是否正确。                                                |
| **BadDeviceToken**        | 指定的设备令牌无效。因此，设备将取消订阅通知。                                                                                                                                      | 验证请求是否包含有效令牌，并且令牌与环境匹配。                                                                                                                                                                                                                                                                          |
| **DeviceTokenNotForTopic** | 指定的令牌不适合向指定主题（创建 iOS 应用程序时指定的包名）发送通知。设备将取消订阅通知。 | 使用适合向此主题发送通知的令牌。                                                                                                                                                                                                                                                                                             |
| **ExpiredCertificate**    | 此应用程序的 APNS 证书已过期。                                                                                                                                                      | 使用 [此指南](/zh/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration#generating-a-certificate-request-file) 创建有效证书，并检查平台配置是否正确。                                                |
| **FrequencyCapping**      | 设备已通过 [Frequency Capping](/zh/product/messaging-channels/global-frequency-capping) 进行过滤。                                                               | 如果这不是预期行为，请检查 [Frequency Capping](/zh/product/messaging-channels/global-frequency-capping) 设置。                                                                                                                                                                              |
| **InvalidCertificate**    | 此应用程序的 APNS 证书无效。                                                                                                                                                        | 使用 [此指南](/zh/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#generating-a-certificate-request-file) 创建有效证书，并检查平台配置是否正确。                                                |
| **InvalidProviderToken**  | 指定的令牌无效或使用无效证书签名。通知将不再发送到发生此错误的平台。                                                                                                    | 检查平台配置是否正确。                                                                                                                                                                                                                                                                                                                    |
| **InvalidToken**          | 指定的令牌无效。通知将不再发送到发生此错误的平台。                                                                                                                                          | <p>检查平台配置是否正确。</p><p></p><p>此错误通常表示网关不匹配（例如，如果您通过生产网关向开发/沙盒版本发送推送，反之亦然）。此外，您的某些用户可能在其设备上安装了其他版本。</p> |
| **MissingDeviceToken**    | 请求中未指定设备令牌。                                                                                                                                                                          | 验证标头是否包含设备令牌。                                                                                                                                                                                                                                                                                                                   |
| **PayloadIsTooLarge**     | 消息大小超过 4096 字节。                                                                                                                                                       | 减小消息大小。                                                                                                                                                                                                                                                                                                             |
| **RevokedCertificate**    | 此应用程序的 APNS 证书已通过 Apple Developer 管理面板撤销。此平台的推送通知将被禁用。                                                                    | 使用 [此指南](/zh/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#generating-a-certificate-request-file) 更新您的证书。                                                                                                        |
| **SandboxSendingError**   | 未能将消息发送到沙盒 APNS 环境。                                                                                                                                                    | 请稍后重试发送消息。                                                                                                                                                                                                                                                                                                 |
| **TimeoutExceeded**       | 在 1 小时内多次尝试向设备发送消息失败，因为 APNS 服务器未响应。                                                                                                    | 请稍后重试发送消息。                                                                                                                                                                                                                                                                                                 |
| **Unregistered**          | 令牌不再有效。设备将取消订阅通知。                                                                                                                                         | 使用新令牌。                                                                                                                                                                                                                                                                                                                     |