跳至主要內容

X Layer Error Code Reference

更新於
Aug 28, 2026
Quicknode 為您的 RPC 端點Quicknode 錯誤日誌。您可直接從儀表板查看詳細的錯誤資訊，輕鬆識別並解決問題。

HTTP 錯誤代碼​

Let's look at the common HTTP errors you can encounter, what they mean and what you can do to prevent them.

400請求錯誤

HTTP 請求類型不正確（例如：使用 GET 而非 POST）或包含無效字元

401未經授權

當一項或多項安全性要求未獲滿足時，便可能發生此情況，例如：令牌驗證錯誤、IP 位址未在白名單中、JWT 無效等。

403存取遭拒

Endpoint （其中一個原因可能是款項逾期未繳）

403禁止存取 - 未找到自訂追蹤

自訂追蹤代碼未列入白名單（請提交工單以進行審核流程）

404未找到

網址不正確或方法不正確

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
}

EVM RPC Error Codes​

Let's look at the common EVM errors you can encounter, what they mean and what you can do to prevent it.

-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 版本。

-32009Trace requests limitedRPC

我們已將除錯與追蹤方法限制在特定的 RPS 範圍內，以防止節點過載

-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.

EVM 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 等鏈上進行開發時可能遇到的常見錯誤彙整。這些鏈運行於多個客戶端，且各自擁有專屬的錯誤定義。您亦可在此處查看節點客戶端原始碼中提到的錯誤：


如果您遇到其他錯誤代碼，請透過提交服務單告知我們。我們非常樂意為您提供協助

最後更新時間 於