# Windows 错误排查

| 错误                       | 描述                                                                                                                                                                                                                               | 应对措施                                                                                                                                                                                                                                                                                                                      |
| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **BadChannel**             | 推送令牌 (URI) 无效或未被 WNS 识别。                                                                                                                                                                                               | 检查推送令牌并重试。                                                                                                                                                                                                                                                                                                            |
| **BadRequest**             | <p>以下原因可能导致此错误：</p><ul><li>在 `_wns_content_` 字段中指定了无效值（该字段为空或包含编码不正确的 XML）。</li><li>向 WNS 服务发出的 HTTP 请求失败。</li></ul> | 检查请求中的 `_wns_content_` 字段值。                                                                                                                                                                                                                                                                                           |
| **FailedToGetWNSToken**    | <p>以下原因可能导致此错误：</p><ul><li>WNS 当前不可用（此原因更常见）。</li><li>由于凭据无效，WNS 身份验证失败。</li></ul>                                               | 检查凭据并稍后重试。                                                                                                                                                                                                                                                                                                    |
| **InvalidToken**           | 推送令牌无效；设备将取消订阅通知。                                                                                                                                                                                                 | 使用有效令牌。                                                                                                                                                                                                                                                                                                                  |
| **Overload**               | WNS 推送限制超出：WNS 无法处理发送的大量推送。                                                                                                                                                                                     | 尝试减少发送的推送数量。                                                                                                                                                                                                                                                                                                   |
| **PayloadTooLarge**        | 消息大小超过 5000 字节的限制。                                                                                                                                                                                                     | 减小消息大小。                                                                                                                                                                                                                                                                                                                  |
| **TokenForWrongChannel**   | 用于发送推送的凭据，其推送令牌无效。                                                                                                                                                                                               | <ul><li>确保您的应用清单中的包名与在 Pushwoosh Control Panel 中配置平台时指定的凭据匹配。</li><li>仔细检查请求中提供的访问令牌是否与请求通道 URI 的应用的凭据匹配。</li></ul> |
| **Unregistered**           | 推送令牌无效；设备将取消订阅通知。                                                                                                                                                                                                 | 尝试使用新令牌。                                                                                                                                                                                                                                                                                                                |
| **WNSFailed**              | WNS 内部故障导致通知投递失败。                                                                                                                                                                                                     | 稍后尝试再次发送消息。                                                                                                                                                                                                                                                                                                          |
| **WNSUnavailable**         | 在 10 分钟内多次尝试向设备发送消息失败，因为 WNS 服务器未响应。                                                                                                                                                                    | 稍后尝试再次发送消息。                                                                                                                                                                                                                                                                                                          |