Quicknode provides Logs for your RPC endpoints. Easily identify and resolve issues by viewing detailed error information directly from your dashboard.
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
}
Tempo RPC Error Codes
Let's look at the common Tempo 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 不足，或是合約錯誤
Tempo 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 存取日誌的功能。
如果您遇到其他錯誤代碼，請透過提交服務單告知我們。我們非常樂意為您提供協助