跳转至主要内容

X层错误代码参考

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

HTTP 错误代码​

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

400请求错误

HTTP 请求类型不正确（例如，使用 GET 而不是 POST）或包含无效字符

401未授权

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

403访问被禁止

终端已停用（原因之一可能是逾期未付款）

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

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

404未找到

URL 错误或方法错误

413内容过大

请求正文过大

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
}

EVM RPC 错误代码​

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

-32000未找到标题 / 未找到块

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

-32000栈空间已满

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

-32000方法处理程序崩溃

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

-32000执行超时

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

-32000随机数过低

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

-32000未找到过滤条件

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

-32001资源未找到

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

-32002资源不可用

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

-32003交易被拒绝

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

-32004方法不支持

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

-32005超出限制

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

-32006不支持此 JSON-RPC 版本

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

-32009跟踪请求受限

我们已将调试和跟踪方法限制在特定的RPS范围内，以防止节点过载

-32010交易费用超出 gas 限制

Gas 限制设置得太低了

-32011网络错误

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

-32015虚拟机执行错误

智能合约执行错误

-32600请求无效

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

-32601方法未找到

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

-32601无法解析请求

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

-32602参数无效——缺少 0x 前缀

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

-32602超出区块范围限制

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

-32603内部 JSON-RPC 错误

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

-32612自定义路径被阻止

提交请求以启用自定义跟踪功能。

-32613不允许自定义路径

在允许的自定义跟踪中未找到该自定义跟踪。请提交请求，将此跟踪加入白名单。

-32700解析错误

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

3执行已回滚

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

EVM RPC 错误代码示例​

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

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

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


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

最后更新时间 在……上
分享此文档