// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。