// PostgreSQL 錯誤參考

PostgreSQL XX001:資料損壞

PostgreSQL 讀到未通過完整性或檢查碼檢查的資料頁。請把它當成儲存損壞處理:先保護資料,再還原或搶救。

SQLSTATE
XX001
名稱
data_corrupted
類別
內部錯誤
錯誤訊息
invalid page in block 1234 of relation base/16384/16397

它的意義

XX001(data_corrupted)代表從磁碟讀到的頁面無效:標頭是壞的、檢查和不符(啟用資料檢查和時),或是檔案比資料表所需的還短(could not read block ... read only 0 of 8192 bytes)。訊息中的檔案路徑(base/<database oid>/<relfilenode>)用於識別資料表或索引。

PostgreSQL 本身很少造成這種情況。常見原因是磁碟或控制器故障、儲存設備謊報已排清寫入、在不具備正確寫入順序的硬體上發生當機,或檔案在複製與還原時不一致。

常見原因

  • 硬體或儲存裝置故障:磁碟、RAID 控制器、SAN 或雲端磁碟區。
  • 不遵守 fsync的寫入快取,隨後發生斷電或崩潰。
  • fsync = off 或 full_page_writes = off 在正式環境中。
  • 複製資料目錄做出的備份,卻沒有 pg_basebackup 或備份 API,或被其他軟體變更過的檔案。

如何修正

  1. 在嘗試任何修復之前,先停止資料庫並為整個資料目錄建立檔案層級的複本,這樣無論做什麼都不會讓情況更糟。

  2. 找出該檔案屬於哪個物件。

    SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
  3. 如果是索引,請重建索引。

    REINDEX INDEX CONCURRENTLY orders_pkey;
  4. 如果是資料表,請從備份或複本還原。作為救回可讀取資料列的最後手段, zero_damaged_pages = on 讓 PostgreSQL 在你把資料表複製出來時跳過損壞的頁面(其資料列會遺失)。

    SET zero_damaged_pages = on;  -- superuser, salvage only
    CREATE TABLE orders_salvage AS SELECT * FROM orders;
    RESET zero_damaged_pages;
  5. 檢查硬體與儲存記錄,並在新叢集上啟用資料檢查碼(initdb --data-checksums,或 pg_checksums --enable 在已停止的叢集上) 以便及早偵測到損毀。

相關錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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