Quicknode 为您的 RPC 端点提供错误日志。您可直接在仪表盘中查看详细的错误信息，从而轻松识别并解决问题。
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
}
Immutable zkEVM RPC Error Codes
Let's look at the common Immutable zkEVM 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不足或合约错误所致
Immutable zkEVM 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 访问权限。
如果您遇到其他错误代码，请通过提交工单告知我们。我们非常乐意为您提供帮助。