Quicknode provides Logs for your RPC endpoints. Easily identify and resolve issues by viewing detailed error information directly from your dashboard.
HTTP 错误代码
下面我们来看看您可能会遇到的常见 HTTP 错误代码、它们的含义以及如何预防这些错误。
400请求错误
HTTP 请求类型不正确（例如，使用 GET 而不是 POST）或包含无效字符
401未授权
当一项或多项安全要求未得到满足时，可能会发生这种情况，例如令牌认证错误、IP 地址不在白名单中、JWT 无效等。
403访问被禁止
终端已停用（原因之一可能是逾期未付款）
403访问被禁止 - 未找到自定义跟踪
自定义跟踪代码未被列入白名单（请提交工单以完成审批流程）
413请求实体过大
eth_getLogs 和 eth_newFilter 仅支持 10,000 个区块的范围。在请求日志和事件时，我们强制执行 10,000 个区块范围的限制。
429请求过多
您的每秒请求数（RPS）超出了套餐允许的范围。请查阅我们的支持文档，了解有关 429 错误的更多信息。
500服务器内部错误
请提交工单，以便支持团队尽快检查这些错误
503服务不可用
请提交工单，以便支持团队尽快检查这些错误
HTTP 错误代码示例
下面的代码片段是一个错误代码429 的示例。
{
"jsonrpc": "2.0",
"error": {
"code": 429,
"message": "The requests per second (RPS) of your requests are higher than your plan allows."
},
"id": 1
}
Zcash RPC Error Codes
Let's look at the common Zcash RPC Error Codes you can encounter, what they mean and what you can do to prevent them.
该节点上不存在所请求的区块。区块编号无效，或者您访问的节点尚未同步完成。请使用带有递增超时的重试机制
-32000栈空间已满
通常是智能合约错误/漏洞——栈限制已达到 1024（1023）
-32000方法处理程序崩溃
区块链客户端出现内部错误，这可能是客户端的故障。请提交工单，以便我们对节点进行复核
-32000执行超时
在请求中添加 timeout 参数，以覆盖默认的客户端超时时间。
-32000随机数过低
您交易中指定的非ce值低于发件人账户的下一个有效非ce值。
-32000未找到过滤条件
过滤器超时；您需要重新创建该过滤器。
-32002资源不可用
所请求的资源暂时或永久不可用。
-32003交易被拒绝
由于验证失败或资源不足，无法创建该交易。
-32004方法不支持
服务器未实现或不支持所请求的方法。
-32005超出限制
该请求超出了允许的限制或配额。
-32006不支持此 JSON-RPC 版本
服务器不支持指定的 JSON-RPC 版本。
-32009跟踪请求受限
我们已将调试和跟踪方法限制在特定的RPS范围内，以防止节点过载
-32010交易费用超出 gas 限制
Gas 限制设置得太低了
-32011网络错误
当客户端与服务器之间的连接出现问题时（例如超时或连接中断），就会发生此错误
-32600请求无效
JSON 请求格式不正确或缺少必填字段。请确保其符合预期格式
-32601方法未找到
通常是方法名中的拼写错误；请检查是否有拼写错误
-32601无法解析请求
请求正文不正确；请仔细检查方法参数
-32602参数无效——缺少 0x 前缀
请求错误；地址中缺少 0x。十六进制数
-32602超出区块范围限制
eth_getLogs 和 eth_newFilter 的范围限制为 10,000 个区块。请参阅我们的支持文档以获取详细说明。
-32603内部 JSON-RPC 错误
此错误通常是由于有效载荷有问题或无效所致
-32612自定义路径被阻止
提交请求以启用自定义跟踪功能。
-32613不允许自定义路径
在允许的自定义跟踪中未找到该自定义跟踪。请提交请求，将此跟踪加入白名单。
-32700解析错误
收到无效的 JSON。服务器在解析 JSON 文本时遇到错误
3执行已回滚
该交易在执行过程中被回滚，这可能是由于条件未满足、Gas不足或合约错误所致
Zcash RPC Error Code Example
下面的代码片段是错误代码-32601 的示例。
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32601,
"message": "the method eth_randomMethod does not exist/is not available"
}
}
上述定义的 RPC 错误是一组在 ETH、BSC、Polygon 等链上进行开发时可能遇到的常见错误。这些链运行在多个客户端上，每个客户端都有各自的错误定义。您也可以在此处查看节点客户端源代码中提到的错误：
Quicknode 会为您的 RPC 端点提供日志，以帮助您排查问题。您可以在Quicknode 控制台中直接查看日志，方法是导航至：
- 侧边栏中的端点
- 选择您的终端
- 打开“日志”选项卡
您可以按时间范围、响应类型、方法和网络对日志进行筛选。
记录的内容
端点请求
发送到您端点的请求，包括 HTTP 状态、请求方法、RPC 方法或路径以及时间戳。
错误详细信息
如有提供，失败的请求将包含错误详细信息，例如 RPC 错误代码、请求和响应正文，以及相关文档的链接。
日志记录限制
日志的可用性可能因方法、响应类型、网络和套餐而异。为保持端点性能最佳，日志记录采用“尽力而为”的原则。在流量高峰期间，为保持低延迟，部分日志可能会被丢弃。
保留与访问
“构建”和“扩展”套餐包含仪表盘访问权限，并提供标准日志保留服务。 “企业”套餐则提供更长的日志保留期限，以及用于检索日志的程序化 API 访问权限。
如果您遇到其他错误代码，请通过提交工单告知我们。我们非常乐意为您提供帮助。