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未找到篩選條件
篩選器已超過超時限制；您必須重新建立該篩選器一次。
-32001資源未找到
所請求的資源不存在或無法取得。
-32002資源不可用
所請求的資源暫時或永久無法取得。
-32003交易遭拒
由於驗證失敗或資源不足，無法建立此交易。
-32004不支援此方法
伺服器未實作或不支援所請求的方法。
-32005超出限制
此請求已超過允許的限制或配額。
-32006不支援此 JSON-RPC 版本
伺服器不支援您指定的 JSON-RPC 版本。
-32009追蹤請求數量有限
我們已將除錯與追蹤方法限制在特定的 RPS 範圍內，以防止節點過載
-32010交易費用超過 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 存取日誌的功能。
如果您遇到其他錯誤代碼，請透過提交服務單告知我們。我們非常樂意為您提供協助