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
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
-
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.
-
Verifica que el servidor ejecute la última versión menor de su versión principal; las versiones menores corrigen muchos errores internos.
SELECT version();
-
Si el error se repite en una tabla, comprueba si está corrupta (la
amcheckextensión verifica los índices B-tree y, desde PostgreSQL 14, las tablas heap conpg_amcheck), y restaura desde la copia de seguridad si hace falta.CREATE EXTENSION IF NOT EXISTS amcheck; SELECT bt_index_check('orders_pkey'); -
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.
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.