// PostgreSQL 錯誤參考

PostgreSQL XX000:內部錯誤

PostgreSQL 遇到了開發者認為不可能發生的狀況。通常是與並行 DDL 的競爭條件,有時是程式錯誤或資料損壞。請記下詳細資訊。

SQLSTATE
XX000
名稱
internal_error
類別
內部錯誤
錯誤訊息
cache lookup failed for relation 16397

它的意義

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 本身或擴充套件的錯誤,通常會在之後的次版本中修復。
  • 硬體或儲存裝置故障後,目錄或資料表資料損毀。

如何修正

  1. 重試該語句。如果是與 DDL 的競爭條件,一旦其他變更完成後它就會成功。

  2. 確認伺服器正在執行其主版本的最新小版本;小版本修復了許多內部錯誤。

    SELECT version();
  3. 如果錯誤在某個資料表上重複出現,檢查它是否損壞(該 amcheck 擴充功能會驗證 B-tree 索引,自 PostgreSQL 14 起也會驗證堆積資料表,用的是 pg_amcheck),並在需要時從備份還原。

    CREATE EXTENSION IF NOT EXISTS amcheck;
    SELECT bt_index_check('orders_pkey');
  4. 如果你能重現問題,請回報到 PostgreSQL 錯誤清單,附上版本、完整錯誤訊息,以及 \set VERBOSITY verbose,以及一個腳本。

相關錯誤

更多內部錯誤類別的錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。