PostgreSQL XX000:內部錯誤
PostgreSQL 遇到了開發者認為不可能發生的狀況。通常是與並行 DDL 的競爭條件,有時是程式錯誤或資料損壞。請記下詳細資訊。
- SQLSTATE
XX000- 名稱
internal_error- 類別
- 內部錯誤
它的意義
XX000 (internal_error)是內部錯誤的代碼,經由 elog(ERROR, ...),PostgreSQL 把它用在正常操作下不該發生的狀況。訊息簡短且技術性,例如 cache lookup failed for relation 16397, could not find pathkey item to sort 或 unexpected chunk number.
有些是因為另一個工作階段還在使用某個資料表或函式時,該物件被刪除而觸發;其他則指向 PostgreSQL 或擴充功能中的錯誤,或是資料損毀——尤其是同一物件上重複發生時。
常見原因
- 並行 DDL:某個物件被刪除或重新建立時,另一個工作階段的查詢仍以 OID 參照該物件。
- PostgreSQL 本身或擴充套件的錯誤,通常會在之後的次版本中修復。
- 硬體或儲存裝置故障後,目錄或資料表資料損毀。
如何修正
-
重試該語句。如果是與 DDL 的競爭條件,一旦其他變更完成後它就會成功。
-
確認伺服器正在執行其主版本的最新小版本;小版本修復了許多內部錯誤。
SELECT version();
-
如果錯誤在某個資料表上重複出現,檢查它是否損壞(該
amcheck擴充功能會驗證 B-tree 索引,自 PostgreSQL 14 起也會驗證堆積資料表,用的是pg_amcheck),並在需要時從備份還原。CREATE EXTENSION IF NOT EXISTS amcheck; SELECT bt_index_check('orders_pkey'); -
如果你能重現問題,請回報到 PostgreSQL 錯誤清單,附上版本、完整錯誤訊息,以及
\set VERBOSITY verbose,以及一個腳本。
相關錯誤
更多內部錯誤類別的錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。