PostgreSQL 08000 en base de datos: excepción genérica de conexión

Aviso: Sigue el orden documentado. Un código identifica el sistema afectado, pero por sí solo no demuestra qué pieza está averiada.

1. 1

   Aviso al soporte con hora exacta

   Sin herramientas especiales

   Quién:

   tú, quien usa la aplicación.

   Cómo:

   anota hora, pantalla y mensaje y avisa al soporte; no reenvíes formularios de pago o pedido.

   Resultado que importa:

   que el soporte pueda cruzar la hora con los registros.

   Si varias personas lo ven a la vez:

   indica un problema del servidor o de la red, no de tu equipo.

   Si solo te pasa a ti:

   apunta a tu conexión o a tu sesión; el desarrollador lo confirmará.

   Evidencia a conservar:

   captura del mensaje con la hora.

   Evidencia: PostgreSQL 18 Appendix A: Error Codes

2. 2

   Disponibilidad del servidor con pg_isready

   Requiere herramientas

   Quién:

   tú, como desarrollador o DBA.

   Cómo:

   ejecuta pg_isready con el mismo host y puerto que usa la aplicación (-h, -p, -t).

   Resultado que importa:

   el código de salida: 0 acepta, 1 rechaza, 2 sin respuesta, 3 sin intento.

   Si sale 1 o 2:

   confirma que el servidor no acepta conexiones o no responde; pasa al DBA.

   Si sale 0:

   descarta el servidor caído y revisa el cliente y la red.

   Evidencia a conservar:

   salida de pg_isready con hora.

   pg_isready solo comprueba; no reinicies el servidor ni cambies su configuración, eso es tarea del DBA.

   Evidencia: PostgreSQL 18 pg_isready

3. 3

   Estado de la conexión en el cliente

   Sin herramientas especiales

   Quién:

   tú, como desarrollador.

   Cómo:

   en libpq consulta PQstatus, PQerrorMessage y PQtransactionStatus tras el error; en otros drivers, su equivalente.

   Resultado que importa:

   si la conexión quedó en CONNECTION_BAD y si había una transacción abierta.

   Si queda en CONNECTION_BAD:

   confirma la pérdida; descarta el objeto o usa PQreset.

   Si PQtransactionStatus da PQTRANS_UNKNOWN con una escritura en curso:

   no la repitas sin comprobar si se confirmó.

   Evidencia a conservar:

   mensaje de PQerrorMessage y estado devuelto.

   Evidencia: PostgreSQL database connection control functions · PostgreSQL 18 libpq connection status functions

Un código solo tiene significado dentro del producto y la versión correctos.

El apéndice A asigna 08000 a connection_exception, el código general de la clase 08 Connection Exception. La clase incluye condiciones más concretas como 08001, 08003 y 08006; cuando llega 08000, el cliente o el servidor solo sabe que hubo un problema de conexión. PostgreSQL recomienda tratar el error por su clase si no se reconoce el código concreto. En libpq, una conexión que falla pasa a CONNECTION_BAD y PQreset la cierra y reabre con los mismos parámetros. El código no dice si falló la red, el servidor o la configuración del cliente.

• Precauciónadvertencia editorial

  Repetir a ciegas una escritura tras un error de conexión puede duplicarla. Detente y comprueba primero si se confirmó.

  Evidencia: PostgreSQL 18 libpq connection status functions

1. 1

   PostgreSQL 18 Appendix A: Error Codes

   PostgreSQL Global Development Group · 2026 · official_doc

2. 2

   PostgreSQL error and notice fields

   PostgreSQL Global Development Group · 2026 · official_doc

3. 3

   PostgreSQL database connection control functions

   PostgreSQL Global Development Group · 2026 · official_doc