// Referência de erro do PostgreSQL

PostgreSQL XX000: erro interno

O PostgreSQL encontrou uma condição que seus desenvolvedores consideram como impossível. Frequentemente, uma corrida com DDL concorrente, às vezes um bug ou corrupção. Note os detalhes.

SQLSTATE
XX000
Nome
internal_error
Categoria
Erro interno
Mensagem de erro
cache lookup failed for relation 16397

O que significa

XX000 (internal_error) é o código para erros internos gerados com elog(ERROR, ...), que o PostgreSQL usa para condições que não deveriam ocorrer em operação normal. As mensagens são concisas e técnicas, como cache lookup failed for relation 16397, could not find pathkey item to sort ou unexpected chunk number.

Alguns são desencadeados pela exclusão de uma tabela ou função enquanto outra sessão a estava usando. Outros apontam para um bug no PostgreSQL ou em uma extensão, ou para corrupção de dados, especialmente quando se repetem no mesmo objeto.

Causas comuns

  • DDL concorrente: um objeto foi excluído ou recriado enquanto a consulta de outra sessão se referia a ele pelo OID.
  • Um bug no PostgreSQL ou em uma extensão, geralmente corrigido em uma versão minor posterior.
  • Catálogo ou dados da tabela corrompidos após uma falha de hardware ou armazenamento.

Como corrigir

  1. Tente executar novamente a instrução. Se foi uma condição de corrida com DDL, ela terá sucesso assim que a outra alteração terminar.

  2. Verifique se o servidor está executando a versão menor mais recente da sua versão principal; versões menores corrigem muitos erros internos.

    SELECT version();
  3. Se o erro se repetir em uma tabela, verifique-a quanto à corrupção (a amcheck a extensão verifica índices B-tree e, desde o PostgreSQL 14, tabelas heap com pg_amcheck), e restaurar a partir do backup, se necessário.

    CREATE EXTENSION IF NOT EXISTS amcheck;
    SELECT bt_index_check('orders_pkey');
  4. Se você puder reproduzi-lo, reporte-o à lista de bugs do PostgreSQL com a versão, o erro completo com \set VERBOSITY verbose, e um script.

Erros relacionados

Mais erros de erro interno

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.