// Referencia de errores de PostgreSQL

PostgreSQL 08006: fallo de conexión

La conexión con el servidor se interrumpió durante el uso. El proceso del servidor terminó, se reinició o lo mataron, o la red cortó una conexión inactiva.

SQLSTATE
08006
Nombre
connection_failure
Categoría
Excepción de conexión
Mensaje de error
server closed the connection unexpectedly
	This probably means the server terminated abnormally
	before or while processing the request.

Qué significa

08006 es un código del lado del cliente: los controladores lo reportan cuando una conexión establecida falla en medio de una conversación. El servidor no puede enviar un error a través de una conexión que ya no funciona, por lo que el mensaje proviene de la biblioteca del cliente. Las herramientas basadas en libpq (psql, psycopg) imprimen el mensaje anterior, y PgJDBC reporta SQLSTATE 08006 con An I/O error occurred while sending to the backend.

El registro del servidor normalmente lo explica: un fallo y reinicio del backend, un kill por falta de memoria, un administrador que terminó la sesión, o nada en absoluto cuando un firewall o un balanceador de carga descartó en silencio una conexión TCP inactiva.

Causas comunes

  • El proceso del servidor de la sesión falló o fue terminado, a menudo por el OOM killer del sistema operativo, lo que obliga a PostgreSQL a reiniciar todas las sesiones.
  • El servidor se reinició o se produjo un failover.
  • Un firewall, una puerta de enlace NAT o un balanceador de carga en la nube cerró una conexión inactiva que superaba su tiempo de espera.
  • La sesión fue terminada por pg_terminate_backend() o por un tiempo de espera de inactividad, y el cliente solo se enteraba en su siguiente consulta.

Cómo solucionarlo

  1. Revisa el registro del servidor en el momento aproximado del fallo en busca de terminated by signal, server process ... was terminated, o un reinicio.

  2. Si una conexión inactiva fue cerrada por la red, habilita los TCP keepalives en el servidor (o en el cliente) para que la conexión nunca parezca inactiva.

    ALTER SYSTEM SET tcp_keepalives_idle = 60;
    ALTER SYSTEM SET tcp_keepalives_interval = 10;
    ALTER SYSTEM SET tcp_keepalives_count = 6;
    SELECT pg_reload_conf();
  3. Configura el grupo de conexiones para validar o reciclar conexiones antes de entregarlas, y reintenta la operación una vez con una conexión nueva cuando sea seguro hacerlo.

  4. Si el servidor se quedó sin memoria, busca la consulta que la usó y reduce work_mem o el número de conexiones concurrentes.

Errores relacionados

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.