// PostgreSQL 错误参考

PostgreSQL XX000:内部错误

PostgreSQL 遇到了开发者认为不可能发生的情况。通常是与并发 DDL 的竞态,有时是 bug 或数据损坏。请记下错误详情。

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 或扩展中的 bug,或数据损坏——当它们在同一对象上反复出现时尤其如此。

常见原因

  • 并发 DDL:在另一个会话的查询通过 OID 引用对象时,对象被删除或重新创建。
  • PostgreSQL 或扩展中的错误,通常在后续的小版本中得到修复。
  • 硬件或存储故障后,目录或表数据损坏。

如何修复它

  1. 重试该语句。如果这是与 DDL 的竞态,等其他更改完成后,重试就会成功。

  2. 检查服务器是否在运行其大版本中的最新小版本;小版本会修复许多内部错误。

    SELECT version();
  3. 如果错误在某个表上重复出现,请检查它是否损坏(该 amcheck 扩展验证 B 树索引,并且自 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。