// справочник ошибок 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, heap-таблицы с pg_amcheck), и при необходимости восстановите из резервной копии.

    CREATE EXTENSION IF NOT EXISTS amcheck;
    SELECT bt_index_check('orders_pkey');
  4. Если удаётся её воспроизвести, сообщите о ней в список ошибок PostgreSQL с указанием версии, полного текста ошибки с \set VERBOSITY verboseи скрипта.

Связанные ошибки

Больше внутренних ошибок

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.