> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见错误代码

> 理解 RPC 错误消息及其解决方案

与 OrbitFlare RPC 端点交互时，您可能会遇到以下标准 HTTP 错误代码。本指南帮助您理解这些错误的含义以及如何解决它们。

## HTTP 状态码

| 错误代码 | 错误消息                  | 描述                    | 解决方案                                                                   |
| ---- | --------------------- | --------------------- | ---------------------------------------------------------------------- |
| 401  | Unauthorized          | API 密钥或认证令牌无效。        | - 验证您的 API 密钥是否正确<br />- 检查您的 API 密钥是否具有所需权限<br />- 确保 API 密钥在请求头中正确设置 |
| 403  | Forbidden             | 由于权限不足或 IP 限制导致访问被拒绝。 | - 如果启用了 IP 限制，验证您的 IP 是否在白名单中<br />- 检查您的订阅计划是否允许所请求的操作                |
| 429  | Too Many Requests     | 您已超出订阅层级的速率限制。        | - 在应用程序中实施请求速率限制<br />- 考虑升级到具有更高限制的层级<br />- 在仪表板中检查当前使用情况            |
| 500  | Internal Server Error | 服务器发生意外错误。            | - 短暂延迟后重试请求<br />- 如果问题持续，请联系我们的支持团队                                   |
| 502  | Bad Gateway           | 上游服务临时问题。             | - 稍后重试请求<br />- 如果持续出现，检查我们的状态页面了解是否有正在进行的事件                           |
| 503  | Service Unavailable   | 服务暂时不可用或正在维护中。        | - 使用指数退避重试<br />- 检查我们的状态页面了解维护公告                                      |
| 504  | Gateway Timeout       | 等待响应时请求超时。            | - 检查您的网络连接<br />- 考虑降低请求的复杂性<br />- 尝试将大请求拆分为更小的块                      |

## JSON-RPC 错误

| 错误代码   | 消息                            | 描述             | 解决方案                |
| ------ | ----------------------------- | -------------- | ------------------- |
| -32700 | Parse error                   | 收到无效的 JSON     | 检查请求格式并确保是有效的 JSON  |
| -32600 | Invalid request               | JSON 有效但请求格式错误 | 验证您的请求是否符合 RPC 方法规范 |
| -32601 | Method not found              | 请求的方法不存在       | 检查方法名称和我们的 API 文档   |
| -32602 | Invalid params                | 方法参数无效         | 审查该方法所需的参数          |
| -32603 | Internal error                | 内部 JSON-RPC 错误 | 重试请求；如果持续出现，请联系支持   |
| -32000 | Server error                  | 通用服务器端错误       | 使用指数退避重试            |
| -32001 | Transaction simulation failed | 交易在模拟期间失败      | 检查交易参数和账户状态         |
| -32002 | Account not found             | 请求的账户不存在       | 验证账户地址是否正确          |
| -32003 | Block not found               | 请求的区块不可用       | 检查该区块是否在可用历史范围内     |
| -32004 | Node unhealthy                | RPC 节点不处于健康状态  | 尝试使用其他 RPC 端点       |

## 最佳实践

1. **实施重试逻辑**
   * 使用指数退避进行重试
   * 设置适当的超时值
   * 优雅地处理速率限制

2. **错误处理**
   * 始终检查错误响应
   * 记录错误详情用于调试
   * 实施适当的回退机制

3. **监控**
   * 在应用程序中监控错误率
   * 为异常错误模式设置告警
   * 跟踪 API 使用量和速率限制消耗

## 支持

如果您遇到持续性问题或需要帮助理解特定错误，请：

1. 查看我们的[状态页面](https://status.orbitflare.com)了解系统状态
2. 加入我们的 [Discord 社区](https://discord.gg/orbitflare)获取快速帮助
3. 联系我们的支持团队获取详细协助

要获取系统状态和维护的实时更新，请关注我们的 [Twitter](https://twitter.com/orbitflarenodes)。