PostgreSQL 08003 en base de datos: se usó una conexión que ya no existe

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

1. 1

   Momento en que se cerró la conexión

   Sin herramientas especiales

   Quién:

   tú, como desarrollador.

   Cómo:

   busca en los registros de la aplicación o del pool cuándo se abrió, prestó, devolvió o cerró la conexión que falló.

   Resultado que importa:

   si el cierre ocurrió antes del uso y quién lo hizo.

   Si la aplicación la cerró antes:

   confirma un error de ciclo de vida en el código; ahí está la corrección.

   Si no hay cierre registrado:

   apunta a una pérdida de comunicación; pasa a la comprobación de red y servidor.

   Evidencia a conservar:

   extracto del registro con hora e identificador de la conexión.

   Evidencia: PostgreSQL 18 Appendix A: Error Codes · PostgreSQL 18 libpq connection status functions

2. 2

   Estado de la conexión antes de reutilizarla

   Sin herramientas especiales

   Quién:

   tú, como desarrollador.

   Cómo:

   en libpq consulta PQstatus antes de reutilizar; en otros drivers, la función equivalente de validación.

   Resultado que importa:

   si devuelve CONNECTION_OK o CONNECTION_BAD.

   Si devuelve CONNECTION_BAD:

   descarta ese objeto y abre otra conexión o usa PQreset, que cierra y reconecta con los mismos parámetros.

   Si devuelve CONNECTION_OK y aun así falla:

   indica que se usa otro objeto distinto del validado; revisa el código.

   Evidencia a conservar:

   versión del driver y estado devuelto.

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

3. 3

   Escrituras que quedaron a medias

   Requiere herramientas

   Quién:

   tú, como desarrollador.

   Cómo:

   si la conexión se perdió con una transacción abierta, comprueba en la base si los cambios están o no antes de repetir nada.

   Resultado que importa:

   si la transacción se confirmó.

   Si los cambios no están:

   confirma que el servidor revirtió la transacción al cerrar; puedes repetirla completa.

   Si no puedes saberlo:

   no repitas la escritura a ciegas; usa una clave que impida duplicarla.

   Evidencia a conservar:

   identificador de la operación y resultado de la comprobación.

   Repetir una escritura de pago o pedido sin comprobarla puede duplicarla. Si no tienes acceso de lectura a esa base, detente y pide la comprobación al DBA.

   Evidencia: PostgreSQL 18 Appendix A: Error Codes · PostgreSQL 18 frontend/backend protocol overview

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

El apéndice A asigna 08003 a connection_does_not_exist, en la clase 08 de excepciones de conexión. Indica que la operación se lanzó sobre una conexión que el cliente ya no tiene abierta. En libpq una conexión pasa a CONNECTION_BAD si falla la comunicación, y PQreset cierra y reabre con los mismos parámetros. El protocolo indica que, si el servidor cierra la sesión, revierte la transacción abierta. El código no dice quién cerró la conexión: la propia aplicación, un pool, la red o el servidor.

• Precauciónadvertencia editorial

  Un bucle de reintentos sobre la misma conexión muerta no la recupera. Abre una conexión nueva y comprueba primero el resultado de cualquier escritura pendiente.

  Evidencia: PostgreSQL 18 libpq connection status functions · PostgreSQL 18 frontend/backend protocol overview

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