// Referencia de errores de PostgreSQL

PostgreSQL XX000: error interno

PostgreSQL encontró una condición que sus desarrolladores consideran imposible. A veces es una condición de carrera con DDL concurrente, otras un bug o corrupción. Anota los detalles.

SQLSTATE
XX000
Nombre
internal_error
Categoría
Error interno
Mensaje de error
cache lookup failed for relation 16397

Qué significa

XX000 (internal_error) es el código de los errores internos que se generan con elog(ERROR, ...), que PostgreSQL usa para condiciones que no deberían producirse en funcionamiento normal. Los mensajes son breves y técnicos, como cache lookup failed for relation 16397, could not find pathkey item to sort o unexpected chunk number.

Algunos se activan cuando se elimina una tabla o función mientras otra sesión la estaba usando. Otros apuntan a un error en PostgreSQL o en una extensión, o a corrupción de datos, especialmente cuando se repiten en el mismo objeto.

Causas comunes

  • DDL concurrente: un objeto que se eliminó o se recreó mientras la consulta de otra sesión hacía referencia a él por OID.
  • Un error en PostgreSQL o en una extensión, muchas veces corregido en una versión menor posterior.
  • Catálogo o datos de tabla corruptos después de un fallo de hardware o de almacenamiento.

Cómo solucionarlo

  1. Vuelve a intentar la instrucción. Si fue una condición de carrera con DDL, tendrá éxito una vez que el otro cambio haya terminado.

  2. Verifica que el servidor ejecute la última versión menor de su versión principal; las versiones menores corrigen muchos errores internos.

    SELECT version();
  3. Si el error se repite en una tabla, comprueba si está corrupta (la amcheck extensión verifica los índices B-tree y, desde PostgreSQL 14, las tablas heap con pg_amcheck), y restaura desde la copia de seguridad si hace falta.

    CREATE EXTENSION IF NOT EXISTS amcheck;
    SELECT bt_index_check('orders_pkey');
  4. Si puedes reproducirlo, repórtalo a la lista de errores de PostgreSQL con la versión, el error completo con \set VERBOSITY verbose, y un script.

Errores relacionados

Más errores internos

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.