跳转至主要内容

Tempo 代码参考

更新于
2026年6月15日
Quicknode 为您的 RPC 端点Quicknode 日志功能。您可直接在仪表盘上查看详细的错误信息,从而轻松识别并解决问题。

HTTP 错误代码

下面我们来看看您可能会遇到的常见 HTTP 错误代码、它们的含义以及如何预防这些错误。

400请求错误

HTTP 请求类型不正确(例如,使用 GET 而不是 POST)或包含无效字符

401未授权

当一项或多项安全要求未得到满足时,可能会发生这种情况,例如令牌认证错误、IP 地址不在白名单中、JWT 无效等。

403访问被禁止

Endpoint (原因之一可能是逾期未付款)

403访问被禁止 - 未找到自定义跟踪

自定义追踪代码未被列入白名单(请提交工单以完成审批流程)

404未找到

URL 错误或方法错误

413内容过大

请求正文过大

413请求实体过大

eth_getLogs 和 eth_newFilter 仅支持 10,000 个区块的范围。在请求日志和事件时,我们强制执行 10,000 个区块范围的限制。

429请求过多

您的每秒请求数(RPS)超出了套餐允许的范围。请查阅我们的支持文档,了解有关 429 错误的更多信息。

500服务器内部错误

Submit a ticket for the support team to take a look at the errors asap

503服务不可用

Submit a ticket for the support team to take a look at the errors asap

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
}

Tempo 错误代码

下面我们来看看您可能会遇到的常见Tempo 代码、它们的含义以及如何预防这些错误。

-32000Header not found / Block not foundRPC

该节点上不存在所请求的区块。区块编号无效,或者您访问的节点尚未同步完成。请使用带有递增超时的重试机制。

-32000Stack limit reachedRPC

通常是智能合约错误/漏洞——栈限制已达到 1024(1023)

-32000Method handler crashedRPC

区块链客户端出现内部错误,这可能是客户端的故障。请提交工单,以便我们对节点进行复核

-32000Execution timeoutRPC

在请求中添加 timeout 参数,以覆盖默认的客户端超时时间。

-32000Nonce too lowRPC

您交易中指定的非ce值低于发件人账户的下一个有效非ce值。

-32000Filter not foundRPC

过滤器超时;您需要重新创建该过滤器。

-32001Resource Not FoundRPC

请求的资源不存在或不可用。

-32002Resource UnavailableRPC

所请求的资源暂时或永久不可用。

-32003Transaction RejectedRPC

由于验证失败或资源不足,无法创建该交易。

-32004Method Not SupportedRPC

服务器未实现或不支持所请求的方法。

-32005Limit ExceededRPC

该请求超出了允许的限制或配额。

-32006JSON-RPC Version Not SupportedRPC

服务器不支持指定的 JSON-RPC 版本。

-32010Transaction cost exceeds gas limitRPC

Gas 限制设置过低

-32011Network errorRPC

当客户端与服务器之间的连接出现问题时(例如超时或连接中断),就会发生此错误。

-32015VM execution errorRPC

智能合约执行错误

-32600Invalid requestRPC

JSON 请求格式不正确或缺少必填字段。请确保其符合预期格式

-32601Method not foundRPC

通常是方法名中的拼写错误;请检查是否有拼写错误

-32601Failed to parse requestRPC

请求正文不正确;请仔细检查方法参数

-32602Invalid params - missing 0x prefixRPC

请求有误;地址中缺少 0x。十六进制数

-32602Block range limit exceededRPC

eth_getLogs 和 eth_newFilter 的范围限制为 10,000 个区块。请参阅我们的支持文档以获取详细说明。

-32603Internal JSON-RPC errorRPC

此错误通常是由于有效载荷有问题或无效所致

-32700Parse errorRPC

收到无效的 JSON。服务器在解析 JSON 文本时遇到错误

3Execution revertedRPC

该交易在执行过程中被回滚,这可能是由于条件未满足、Gas不足或合约错误所致

-32007Per-second request limit reachedQuicknode

You have exceeded your plan's per-second request limit. Reduce the number of calls per second or upgrade your plan at https://dashboard.quicknode.com/billing/plan.

-32008Per-minute request limit reachedQuicknode

You have exceeded your plan's per-minute request limit. Reduce the number of calls per minute or upgrade your plan at https://dashboard.quicknode.com/billing/plan.

-32011Method rate limit reachedQuicknode

You have exceeded a method-specific rate limit configured for the endpoint. Reduce calls to the method or adjust the method rate-limit rule.

-32604Unsupported request methodQuicknode

The request method is empty, missing, or unsupported. Provide a supported JSON-RPC method name.

-32611Request rejected by filter settingsQuicknode

The request was rejected by an endpoint security filter, such as a method allowlist or blocklist. Review the endpoint's request filter settings.

Tempo 错误代码示例

下面的代码片段是错误代码-32601 的示例。

{
	"jsonrpc": "2.0",
	"id": 1,
	"error": {
		"code": -32601,
		"message": "the method eth_randomMethod does not exist/is not available"
	}
}

上述定义的 RPC 错误是一组在 ETH、BSC、Polygon 等链上进行开发时可能遇到的常见错误。这些链运行在多个客户端上,且各客户端拥有各自的错误定义。您也可以在此处查看节点客户端源代码中提到的错误:


Endpoint

Quicknode 为您的 RPC 端点Quicknode 日志,以帮助您排查问题。您可以在Quicknode 直接查看日志,方法是导航至:


  1. 侧边栏中的端点
  2. 选择您的endpoint
  3. 打开“日志”选项卡

您可以按时间范围、响应类型、方法和网络对日志进行筛选。

记录的内容

Endpoint
发送到您endpoint请求,包括 HTTP 状态、请求方法、RPC 方法或路径以及时间戳。

错误详细信息
如有提供,失败的请求将包含错误详细信息,例如 RPC 错误代码、请求和响应正文,以及相关文档的链接。

日志记录限制

日志的可用性可能会因方法、响应类型、网络和套餐而异。为了保持endpoint 最佳endpoint ,日志记录采用“尽力而为”的原则。在流量高峰期间,为了保持低延迟,部分日志可能会被丢弃。

保留与访问

“构建”和“扩展”套餐包含仪表盘访问权限,并提供标准日志保留服务。 “企业”套餐则提供更长的日志保留期限,以及用于检索日志的程序化 API 访问权限。

如果您遇到其他错误代码,请通过提交工单告知我们。我们非常乐意为您提供帮助。