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

HTTP 错误代码

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

400请求错误

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

401未授权

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

403访问被禁止

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

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

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

404未找到

URL 错误或方法错误

413内容过大

请求正文过大

413请求实体过大

Some methods may have limits to prevent overly large requests.

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
}

端点日志

Quicknode 会为您的 RPC 端点提供日志，以帮助您排查问题。您可以在Quicknode 控制台中直接查看日志，方法是导航至：

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

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

记录的内容

端点请求
发送到您端点的请求，包括 HTTP 状态、请求方法、RPC 方法或路径以及时间戳。

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

日志记录限制

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

保留与访问

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

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